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PREFACE 


This manual describes some of the considerations involved in planning and 
building an online application using GCOS/BES2 software. Unless stated other- 
wise, the term BES refers to GCOS/BES2 software; the term Level 6 indicates the 
specific models of Series 60 (Level 6) hardware on which the described software 
executes. GCOS/BES2 software executes on the 6/30 Models of Series 60 (Level 6). 


Section 1 presents the general characteristics of the various categories of 


BES software, and their roles in the development of an online application. 

Section 2 provides details of the capabilities of BES software, presents 
formulas for calculating the sizes of various data structures, and introduces 
such concepts as priority levels and logical resource numbers that provide both 
flexibility and efficiency in the completed application. 

Section 3 describes the use of the Configuration Load Manager. It includes 
a summary chart of the building process from the beginning stage where file 
space is allocated, through program development, to configuration and execution 
of the online application. 


Section 4 provides practical advice on debugging an online application. 


Appendix A contains complete descriptions of the CLM commands and their 


operands. 


Appendix B discusses the use of Executive object modules in building an 


online application. 


Appendix C presents examples of application configuration. 
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SECTION 1 


INTRODUCTION 


This manual shows you how to combine BES software modules with your own 


programs to achieve the functionality you require in your online application. 


The software has a number of features that enable you to concentrate on 
the solutions to your specific application problems, rather than to spend time 


developing, coding, and testing your own standard service routines. 


For example, Executive modules provide routines for task and clock manage- 
ment, and for the control of operator dialog with the software. Also included 
are routines for time and date recording, as well as trap and error handling. 
There is a set of routines that allows you to execute your application as a 
series of overlays — the Overlay Loader provides the basic capabilities for 


loading and starting overlay code. 


The input/output modules provide file management facilities, and reentrant 
routines for driving all available devices. Moreover, the software includes 
Communications modules that function through the standard physical I/O inter- 


face, and can be configured and used as easily as any other peripheral device. 


Furthermore, the modularity of the software allows you to choose only those 
services that you require. For example, you may or may not want to include the 
Executive buffer management capability as an integral part of your configured 


application. 


Since the software is supplied in load module form, you do not have to 
assemble and link the various routines that you want to include in your applica- 
tion. As soon as you have finished developing your programs so that they are 


executable load modules, you are ready to configure your application. 


The process chart in Section 3 gives you an overview of the operations 
involved in building your application. You will be using various functional 
groups of software modules in the building process. For example, in setting 
up your application environment, you will use the utility programs to prepare 


and maintain disk volumes. See the Utility Programs manual for details. 
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You will use components described in the Program Development Tools manual 


to prepare your own application programs. 


To make a realistic debugging environment for online application programs, 


the software provides an Online Debug Program that operates under the Executive. 


When your own load modules are ready for use, you configure your online ap- 
plication by using a software component called the Configuration Load Manager 
(CLM). The CLM, working in conjunction with a loader, provides a load-and-go 
capability for your application. For smaller systems, CLM can be executed as 


a series Of overlays. 


CLM accepts command input in which you have specified the various character- 
istics of your application, such as memory size, numbers and types of devices, 
and the load modules, both BES modules and your own, to be included in the final 
configuration. CLM uses this command information to build the data structures 
and to load the necessary modules that the Executive software uses to control 
processing. A special facility permits user-written application initialization 


during loading. 
After all the specified modules are loaded, CLM turns control over to the 


highest priority task that has been designated as initially active, and applica- 


tion execution begins. 
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SECTION 2 
PLANNING 


Planning an online application includes the process of systems analysis and 
design, taking the fullest advantage of the system services and development tools 
supplied by Honeywell. This process includes: 


Acquiring a familiarity with the capabilities of BES software 


Defining application design objectives 


Defining online environment characteristics 


Designing programs to be run in an online environment 


OVERVIEW OF BES SOFTWARE SERVICES 


BES provides a number of services that you should consider when planning an 
online application. There are also a variety of tools for use in the develop- 
ment of application programs. These software modules are summarized in 
Tables 2-1 and 2-2 below. 


Services Available for Application Execution 


The BES-provided services for use during online application execution are 
summarized in Table 2-1, and described in detail in the Executive and Input/ 


Output manual or the FORTRAN manual, as appropriate. 


Services Available for Application Development . 


The BES-provided tools for use during application development are sum- 
marized in Table 2-2, and described in detail in the Program Development Tools 


and Utility Programs manuals, as appropriate. 


In addition to the services summarized in Table 2-1, BES provides a 
Configuration Load Manager (CLM) which defines the context of the application, 
sets up the required internal data structures, loads the specified modules, and 
initiates execution of the application, all in one continuous operation. The 
Operation of the CLM and the syntax of its commands are described in this 


7 


manual. 
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Table 2-1. BES Software for Application Execution 


Service Description 


Task Manager 


Clock Manager 


Operator Interface Manager 


Buffer Manager 


File Manager 


Overlay Loader 


Communications Supervisor 


Device Drivers 

(Disk, Printer, Card 
Reader, KSR/ASR, VIP, BSC, 
TTY, MLCP) 


Floating-Point Simulator 


Scientific Branch 
Simulator 


Trace Trap Handler 


FORTRAN Run-Time I/O 
Routines (FRIOR) 


Online Debug Program 


COBOL Run-Time Routines 


Monitors and controls all tasks in the applica- 
tion, using data structures defined during 
configuration. The Task Manager oversees the 
level activity indicators, administers the inter- 
rupt structure, and coordinates requests for the 
execution of tasks. 


Activates priority levels after an elapsed time 
interval or at regular time intervals, as speci- 
fied during configuration. An expanded Clock 
Manager is available, providing date and time 
information in ASCII format for external 
reporting. 


Controls all operator dialog with the software 
through a KSR-like device. 


Coordinates requests for buffer space, using 
control structures and buffer pools defined during 
configuration. Use of the Buffer Manager is 
optional but recommended. 


Opens, reads, positions, writes, and closes files; 
reports file status information and error condi- 
tions. Use of the File Manager is required for 
FORTRAN and COBOL programs. 


Controls the loading of planned overlays through 
data structures created by CLM. 


Provides necessary services to communications 
handlers including time-out, request validation, 
and Task Manager interface. 


Perform all data transfers between the online 
application and its respective devices. Drivers 
receive requests for service from the Task 
Manager and run at the priority level of the 
requested device. 


Provides double-precision arithmetic and a 
scientific instruction set. Operates as a trap 
handler under the Executive. 


Operates aS a trap handler under the Executive to 
provide FORTRAN and assembly language programs 
with the means to simulate the use of scientific 
branch instructions. 


Traces the contents of a specified memory loca- 
tion and maintains a limited trace history. 


Provides for reading and writing of formatted and 
unformatted records; edits integer, real, logical, 
and character data for formatted input and output, 
and produces diagnostic messages for inappropriate 
commands. These routines require the use of the 
File Manager. 


Provides online program testing and patching 
facilities for application programs running under 
a BES Executive. 


Supports the COBOL procedural statements that 
involve arithmetic, logical, data manipulation, 
and input/output operations. 
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Table 2-2. BES Software for Application Development 


Utility Programs File maintenance and handling, media transfers, 
printing, debugging. . 


Editor Creates and/or corrects source programs on disk. 


Provides for definition and expansion of macro 
routines. Macro Preprocessor output is input to 
the Assembler. 


Macro Preprocessor 


Assembler 


Produces object modules from source programs 
|written in BES assembly language. 


Produces object programs from source programs 
written in COBOL. 


| Produces object modules from source programs 
written in FORTRAN. 


Produces load modules from object text output of 
all language processors. 


COBOL Compiler 


FORTRAN Compiler 


Linker 


DEFINING APPLICATION DESIGN OBJECTIVES 


The careful description of the specific design objectives of your applica- 
tion is an important part of the overall planning process. You should have a 
precise inventory of the numbers and kinds of problems that your application 
programs will be designed to solve, the files required, and the types of reports 


to be generated. 


This inventory will greatly simplify your assessment of the physical and 
logical resources required to achieve your design objectives. Your inventory 
should contain information about the source language in which your particular 
application program is written because high-level languages such as COBOL and 
FORTRAN require the File Manager to handle the logical input/output operations 
between programs and the physical devices that contain the data read and written 
by those programs. Table 2-3 shows one way of relating a design objective to 


the physical and logical resources needed to implement that objective. 


Table 2-3. Physical and Logical Resource Requirements 


Application Program Resources Needed 
Design Objective Source Language 


COBOL 


Input task 


: 


Produce a report Card Reader 
based on daily 


card input 


Processing task | Disk device 
Output task 


Line printer 


File Manager 


Z=3 AU49 


There are other considerations about the use of logical and physical 
resources that are discussed throughout the remainder of this section. For 
example, the implications of providing certain values in the CLM commands, and 
the use of overlays to conserve memory space. There is a description under 
"Designing Programs for an Online Environment," later in this section, about the 
use of logical resource numbers to coordinate the use of interrupt priority 


levels by tasks and devices. 


DEFINING ONLINE ENVIRONMENT CHARACTERISTICS 


The characteristics of the online environment such as priority level usage, 
trap handling routines, time and date functions, as well as the complement of 
Executive software and file and buffer specifications, are chosen by supplying 
information to the CLM in configuration commands. These commands are described 
in detail in Appendix A; some of their more salient features are presented in 


this section. 


Selecting System Variables 


The information provided in the various commands to the CLM affects the 
numbers and sizes of control structures used by the Executive software to monitor 
processing. Choice of Executive services (and hence the Executive modules) has 
a direct bearing on the amount of available memory remaining for the loading of 
application programs. Table 2-4 summarizes the relationships between parameter 
values of the CLM commands and effects of these values on the sizes of control 
structures and memory usage. (See also "Size Calculations for System Data 


Structures," below.) 


Information for System Data Structures From CLM Commands 


Note that the CLM control commands direct the action of the CLM itself; the 
load configuration commands provide information to the loader that pertains to 
the loading order of the modules, and the identification of references among 
them. 


The system configuration, task, buffer management, and file management 
commands contribute information for the control structures that are used to 
regulate processing in an online application, in addition to providing CLM with 


data needed to calculate the sizes of these control structures. 
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Table 2-4. Effects of CLM Parameters on Memory Usage 


Default 
Default Value Structures 
Range of Values Value (Words) Affected 


LS SS eS Ka 


up to 255 16 LRT size 
lolevel SYS 6<value<62 15 270 Number of ISA's 


hilrn 


himem up to 64K Loader - 
Address 
<halrn LRT and ISA 
level 5<value<lolevel 
number of 2<value< 46 Number of trap 
TSA's save areas 
size 8<value 8 16 Size of trap 


save areas 


trap number TRAP 1 through 46 See Table 2-5 

handler name ASCII name for sizes 

module name ADMOD See Table 2-5 
for sizes 


maxlfn <255 TORB 

224 
| | : 
272 
328 
392 


concurrent 
calis 


concurrent 
opens 


Diskette buffer 


Cartridge disk 
buffer 


irn TASK, ATLRN,| <hilrn Number and size 
DEVICE, TTY, of RCT's 
VIP, BSC. S<value<lolevel 


level 


The effect of some of the parameters in Table 2-4 on the amount of memory 


Space used is small, so that if a default value is taken even when it is higher 
than that needed for a particular parameter, not much memory space is wasted. 
However, you should be careful about assigning higher than necessary values to 
the parameters for the file management commands, particularly the FILMGR com- 
mand. As you can see by inspecting the size calculation formulas that use 
information from this command, a careless assignment of values to the "concur- 
rent calls" and "concurrent opens" parameters will result in the reservation of 


much more space than needed. 


Moreover, the lolevel parameter value should be selected with care. The 
interrupt save areas (ISA) are set aside on the basis of this parameter, so that 
if you supply a value of 30, and actually only use 10 priority levels, 360 words 


remain unused. 
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SIZE CALCULATIONS FOR SYSTEM DATA STRUCTURES 


The system and task commands provide information for the calculation or the 
definition of the sizes of the following data structures: 

LRT - Logical resource table 

ISA - Interrupt save areas 

SOQ - Start of queue header table 

EOQ - End of queue header table 

TSA - Trap save area 

RCT - Resource control table 


The following formulas are used to calculate the sizes of these areas. 


SuRT = (hilrn + 1) 


If the default value is taken for hilrn, the size of this table would be 16 


words. 


= = * 
Sica MIN + (lolevel + 1-4) MAX 


Where MIN = 6 and MAX = 22, If the default value of 15 is taken for lolevel, 
the ISA would be 270 words long. 


S = 5 = (lolevel + 1) 
Using the default value for lolevel, each of these tables would be 16 words long. 


Simsa = (number of blocks) * (blocksize) 
Using the default values for these parameters results in a trap save area 16 


words long. 


A resource control table for a device is 16 words long; an RCT for a task 


is one word long. 


In summary, the size of the area devoted to those data structures defined 


by the system and task commands is: 


where Ny is the number of DEVICE commands, and Spor is the sum of RCT sizes. 

The buffer and file management commands provide information for the defini- 
tion of the following data structures: 

e PPT (pool parameter table) 

e Buffer area 


e Work area for File Manager 
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IORB (input/output request block) 
Diskette buffers 

FDB (file descriptor block) 
FCB (file control block) 
Remote extent block 

Device buffers 

Wait table 

Semaphore table 

VDB (volume descriptor block) 
LFT (logical file table) 

FCB (device) 

e FDB (device) 


The following formulas are used to calculate the sizes of these structures. 


= * 
Sppr 4 words + (2*P) 


where P is the number of size/number pairs indicated in the BUFSPACE command. 


= { 7 e ke we e \ ale { J * 1 mb r 
Suuffer eRe (size, numb r,) + (size, numbe + 
= * 
Suse sare (number of concurrent calls) 40 
a * 
Storr (number concurrent calls) 8 
Saiskette Bueees = (number concurrent calls) * 72 + 64 for cartridge 
disk 
ran * 
Sopp (number concurrent opens) 28 
a * 
Secp (number concurrent opens) 7 
SprR = (2 * number concurrent opens) * 17 


Saewice buffer (number double buffers) * 77 


Swait fie = lolevel +1 
Som = 16 + (2 * (number VDB + number FDB ee 2 + 
maxlfn + 2 + (2 * number pencueeent 
opens) 
= * 
Supp (number FMDISK commands) 48 
SurrT = 1] + maximum ifn + 1 
= * 
Secp (aypee) (number ATFILE commands) (6+1+N/,) 


where N is the pathname length, space-filled to the next highest even number of 
bytes. 


S = (number DEVFILE commands) * 28 


FDB (device) 
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Selecting Executive Modules 


BES software provides an Executive (ZXEX03) as a load module. This Execu- 
tive supplies capabilities for task and clock management, input/output handling, 
overlay loading, initialization processing, Operator interaction with the soft- 
ware, time and date recording, trace trap and system error handling. Applica- 


tions that use the File Manager require this Executive. 


To complement the facilities provided by the Executive, you can also include 
either the File Manager or the Buffer Manager, or both of these load modules in 


your application. All FORTRAN applications require the File Manager. 


You may find that the load module version of the Executive does not exactly 
fit your application specifications, In that case, you can hand tailor an 
Executive load module from Honeywell-supplied object modules. See Appendix B 


for a description of this process. 


Selecting Input/Output Modules 


Input and output operations in your online application are handled by soft- 
ware modules called device drivers. You may select appropriate device drivers 
(or line-type processors for Communications devices) from the set provided by 
Honeywell (in either load or object module form), or you may write your own 
device drivers. See the Executive and Input/Output manual for details of this 


process. 


Table 2-5 contains the names and sizes of the Honeywell-supplied load 


modules. 


Selecting File and Buffer Management Techniques 


If your online application is programmed in assembly language, application 
requirements determine whether the File Manager is required (both FORTRAN and 


COBOL programs require the File Manager) for input and output operations, 


When your application needs only minimal I/O functions, you can gain a 
space advantage by using the device driver alone and save the 3200 words 
occupied by the File Manager. However, you then must program whatever I/O func- 
tions your application does need. The advantage of using the File Manager is 
that it provides these needed functions, and hence, I/O processing with the 


programming simplicity of a higher level language. 


The following discussion illustrates the advantage of using the File 


Manager over a device driver alone when the I/O device is a disk. 
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Table 2-5. Names and Sizes of Honeywell-Supplied Load Modules 


Approximate 
Load Module Size in Words 
Name Description (Decimal ) 
ZXEX03 Executive . 
ZXBMO1 Buffer Manager 
ZYFM02 File Manager 
ZIDSK Diskette Driver 
ZICDSK Cartridge Disk Driver 
ZIKSR Keyboard-Send-Receive Driver 
ZIASR Automatic-Send-Receive Driver 
ZICDR Card Reader Driver 
ZILPT Printer Driver 125 
ZXOVLY Overlay Loader Pa ps) 
ZDBG Online Debug Program (overlay 1200 
version) 
ZQEXEC Communications Supervisor 580 
ZQMLON MLCP Driver 500 
ZQPTTY TTY Line-Type Processor 980 
| ZQPVIP ais 7700 Line-Type Processor | 1270 | 


ZQPBSC 
ZFPSIM 
Z4FBSIM 
TRPHND 


BSC 2780 Line-Type Processor 


Floating-Point Simulator 


Scientific Branch Simulator 


Trace Trap Handler 


NOTE: The names of the object module versions are 
listed in Appendix B. 


When using a device driver alone to perform input/output operations, the 
application program must build its own data structures to interface with the 
driver, and initialize those structures with the data that the driver needs in 
order to locate the required data on the device. This information consists of 
the initial sector to be transferred given by the sector number relative to the 


beginning of the volume, and the number of bytes to be transferred. 


After the I/O request is made, the driver will transfer the requested 
number of bytes starting at the boundary of the sector specified. The implica- 
tion of dealing with sectors it twofold: the application program must know, for 
each set of data (logical record) the number of the sector in which the record 
resides. Secondly, if there is more than one logical record per sector, the 


program must do its own deblocking; i.e., must find the logical record it needs. 


By contrast, the File Manager builds the I/O data structure for the program 
and provides the initializing information by which the logical record is 
retrieved when provided with a record number relative to the beginning of the 
Lite, 
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On a read operation, the File Manager transfers the requested data record, 
not the physical sector, into the program's buffer area, and the program then 


does not have to search for and deblock the records itself. 


To summarize, the File Manager works at the program's logical level with 
files and records; a driver works at the hardware physical level with sectors. 
When using nondisk sequential devices, the File Manager provides some measure of 


device independence at the application interface. 


FILE MANAGER BUFFER HANDLING 


The File Manager allows nondisk devices to be buffered. When you configure 
your application, you can request the File Manager to reserve internal space for 
a data buffer for a particular LFN (see the DEVFILE command in Appendix A). The 
purpose of this buffering is to allow application code to execute in parallel 
with I/O transfers. 


File Manager achieves parallel processing in two different ways, depending 
on whether the LFN is used for obtaining data from a device (reading), or 


transferring data to a device (writing) .? 


Buffered Read Operations 


A buffered read results in an anticipatory read in addition to every read 
command issued by the application. When the LFN represents a card reader, this 
means that a second card will be read immediately after the application reads 
(and waits for the data to arrive in its buffer) the first card after the LFN is 
opened. The application can now process the data it has while the physical I/0 


transfer for the next card into the File Manager's buffer is in progress. 


Nondisk file types recognized by the File Manager may be classified as 
interactive or noninteractive. Interactive device names are: KSR, KSI, KSO, 
ASR, ASI, ASO, VIP, VIPI, VIPO, TTY, TTYI, TTYO (see DEVFILE command in 
Appendix A). 


Buffered interactive and noninteractive file types operate exactly the same 
after they are opened. A noninteractive file, when opened, does not initiate an 
anticipatory read by the File Manager. This means that the application must 
wait for the physical I/O transfer to occur on the first read; thereafter the 
parallel operation described above, occurs. 


leidirectional LFN's cannot be buffered. 
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An OPEN command to an interactive file type does cause an anticipatory read 
into the File Manager's buffer to occur. If the application program immediately 
followed the OPEN with a READ command, the effect is exactly the same as for a 
noninteractive file type; i.e., the application is suspended until the read 
operation into the File Manager's buffer completes and data is moved into the 
application program's buffer. However, the application program can avoid 
suspension on the first or subsequent READ commands by using the Status Read 
command, which gives the program immediate information as to whether the File 
Manager's buffer now contains the next record. If not, the application program 
can continue processing and only perform the read operation when the result of 
the Status Read indicates that data is available. 


The primary use for buffering an interactive file type is to allow an 
application to control input from more than one LFN, each of which represents a 
console at which operators enter data. The application program cannot perform a 
READ on any particular LFN, and wait until data arrives because the operator at 
that terminal may not be present, and the application program is then indefi- 
nitely suspended. To avoid this indefinite suspension, the Status Read should 
be used, in this way the application program will never perform a READ unless 
data is present. (It is because of the indefinite response on an input LFN that 
the OPEN command to an interactive file type causes the anticipatory read, thus 
the Status Read is meaningful for all read operations, not only for the first 


one.) 


Buffered Write Operations 


A buffered write operation to an LFN works on behalf of the application 
program in the same logical manner as the read — the program is permitted to 
execute in parallel with the physical I/O transfer to the device. To achieve 
this parallel processing, no special operation occurs on an OPEN command, and no 
distinction is made between interactive and noninteractive file types. Each 
write command is completed by moving data from the application buffer to the 
internal File Manager's buffer, initiating the transfer, and returning control 
to the application program. If the program performs a second write operation 
while the internal buffer is still in use for a previous transfer, the applica- 
tion is suspended until the buffer is available and new data moved into it 
again. The application can avoid suspension by using the Status Write command 


to see if the internal buffer is still in use or not. 


Special considerations for buffered write operations arise because, if a 
physical I/O error occurs while data is being transferred from the internal 
buffer to the device, the application program is unaware that an error has 
occurred unless it checks the file status after each write. Furthermore, if an 
error does occur, the application program may need to have saved (or be able to 


retrieve) the data record so that it can be repeated. 
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To summarize, a Status Write should be used to test for buffer availability 
and no error status before each write operation (not required on the first write 


operation) or the close operation of the file. 


INTERACTIVE FILE TYPE/LFN COORDINATION 


Using the File Manager to provide application programs (including those 
written in FORTRAN or COBOL) with read and write capabilities for KSR-like 
devices requires two LFN's, used as a pair. Both LFN's represent the same 
physical device, one for the keyboard input, and the other for the printer 
output. Two LFN's are required because the read LFN must be buffered if more 
than one terminal is being controlled, and a bidirectional, buffered file type 


is not supported by the File Manager. 


Whenever both LFN's are buffered or not depends on the application's needs. 
However, when the terminal being controlled is physically attached to a communi- 
cations controller (MLCP), great care must be taken to coordinate the closing of 
the files involved. If one is closed before the other is finished using the 
terminal, the other LFN will be unable to access the device because the close 
operation causes the connection to be broken. (A media error is returned to the 
application.) For further information, see the discussion of CONNECT (used by 
the File Manager OPEN function), and DISCONNECT (used by the File Manager CLOSE 


function) in the Executive and Input/Output manual. 


PRINTER SPACE CONVENTIONS 


In planning an application that uses line printers and terminals (consoles) 
interchangeably, you must consider the differences in format conventions between 


these two types of devices. 


The line printer driver (and the IORB within the File Manager for the LPT 
device-file) assume that a space-before-print convention is appropriate. The 


device-specific word and the format control byte allow convenient prespacing. 


The teleprinter driver allows prespacing but also supports post-line feed 
operations usually associated with console-oriented print-then-space conven- 
tions. This convention is designed to allow input to begin on a new line with- 


out doing a line feed after a key is struck. 


The File Manager's preconfigured IORB associated with any KSR-like device 


assumes a post-line feed is desirable. 


The application can accommodate either convention, by itself, without 
difficulty, but if the devices are interchangeable, care must be taken to avoid 
either: 


e Double spacing because the format byte specifies prespace one line, 
and the teleprinter IORB enforces a post-line feed 
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e Overprinting because the format byte specifies no prespace, and the 
line printer does not support post-line feed 


The distinction as to device type is made, using the File Manager, by 
interrogation of file type status. Physical I/O can discover the difference by 


locating the RCT for the particular LRN and testing the device ID. 


DESIGNING PROGRAMS FOR AN ONLINE ENVIRONMENT 


As you design your application programs, remember that they will be using 
some of the same system resources that are used by the Executive software. For 
this reason, your application programs should conform to certain conventions 
that make the joint usage of these resources as efficient and error-free as 
possible. These conventions concern the use of interrupt priority levels, the 
definition of control structures, the use and saving of registers, as well as 
the standard ways of defining, identifying, and calling the various Executive 


and application modules. 


Multitasking 


The following paragraphs describe what has to be done to set up your 
application for multitasking execution. Appendix C contains a sample program 


that illustrates configuration, linking, task control blocks, and tasking. 


A task is a sequence of executable code whose execution is initiated and 
terminated by calling task management functions described in the Executive 
Manual. When several tasks can be active simultaneously you have multitasking. 
The criterion used by firmware to select a task for execution, from among those 
have been initiated and are active, is the task's priority level; the task asso- 


ciated with the highest priority level is the one to be scheduled next. 


PRIORITY LEVELS 


Each task and device (i.e., the device driver task) is associated with a 
priority level number, reflecting its relative processing priority in an appli- 
cation. In this priority scheme, the lower the level number the higher the 
priority. Table 2-6 contains a list of possible relative priorities for tasks. 
Level 0 through 4 (the five highest priority levels) and level 63 (the lowest 
level) are reserved for system use and do not need to be specified during 
configuration. All other levels are available for use by application program 
tasks and devices. 


Table 2-6 includes all the devices that currently are supported on Level 6 


hardware. If fewer devices are used, fewer levels are needed while maintaining 


the relative position of the levels. It is suggested that consecutive levels be 
used, without skipping a level number, to save data structure space that would 


otherwise be reserved for the unused levels. 


2-13 AU49 


Table 2-6. Relative Priority Level Assignments 


0 
- 
2 
3 
4 


Power failure handler 

Watchdog timer runout 

Trap save area overflow 

Inhibit interrupts 

System clock 

Communications interrupt 

Communications Devices (less than or equal to 9600 bps) 
Cartridge disks 

Communications Devices (less than or equal to 1200 bps) 
Diskettes 

Printers 

Card readers 

ASR/KSR 

Online Debug Program 

Operator Interface Manager interrupt 

Input/foutput - bound application tasks 

Central processor - bound application tasks 


63 System idle loop (always active) 


The table indicates I/O devices, and not device drivers, to stress that 
each (noncommunications) peripheral device must have at least one level assigned 
to it; peripherals cannot share a level. If there are two printers, each must 
be assigned a unique level. Actually, when a device level is initiated, it is 
a reentrant I/O driver that is initiated of which only one copy need be in 


memory. 


Communications requires one nonshareable level dedicated to processing com- 
munications interrupts, and it must be at a higher level than any communications 
devices. Communications devices can share a level. For example, four TTY's and 


one VIP can either share one level or be configured to use up to four levels. 


The listed priority arrangement is designed to provide maximum throughput 
for each device by assigning the high transfer rate devices a higher priority 
than the lower transfer rate devices. I/O-bound tasks are run at a higher 
priority than central processor-bound tasks since this enables I/O-bound tasks, 
which run in short bursts, to issue I/O data transfer orders as needed, wait for 
I/O completion, and while in the wait state, relinquish control of the central 
processor to the central processor-bound tasks. Otherwise, if the central 
processor-bound tasks had a higher priority, the I/O devices would be idle while 
I/O-bound tasks wait to receive central processor time. The criteria used to 
specify Table 2-6 might not suit a particular application and the ievel assign- 


ments should be modified to include other priority considerations. 
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LOGICAL RESOURCE NUMBERS 


To enable an application program to be independent of level numbers, the 
software provides logical resource numbers (LRN's) to associate application 


tasks and devices with priority levels. 


An LRN (and not level number) is given with each task request to indicate 
the level at which the task is to execute. The level at which the task executes 
is determined finally by the level that was attached to the LRN at configuration 
time. If level changes are to be made, the application only has to be recon- 


figured with the new level; the program does not have to be changed. 


Aithough an LRN is attached to a unique level, more than one LRN can be 
attached to the same level when LRN's are used synonymously (e.g., two 
independently created tasks refer to the same task by different LRN's), or when 


tasks or communications devices share the same level. 


Figure 2-1 illustrates an association between tasks of an application and 
priority levels. The first column describes the task to be initiated. During 
task initiation the task is associated with one of the LRN‘'s in the second 
column which was attached, at configuration time, to one of the priority levels 
listed in the third column. The level assignments follow the priority scheme 
listed in Table 2-6. 


TASK LRN 

ASSOCIATED ATTACHED 

INITIATED TASK WITH LRN TO LEVEL 
Communications Interrupt 5 


Local TTY Driver (Operator's Console) 0 
Remote TTY 2 Driver 1 6 
VIP 1 Driver 2 

3 


Cartridge Disk Driver 

VIP 2 Driver (Input) 4 

VIP 2 Driver (Output) | 

Remote TTY 1 Driver 6 

Diskette 1 Driver 7 10 

Diskette 2 Driver 8 

Line Printer Driver 9 i Fa 

Task l 10 L2 

Task 2 | x 

Task 3 12 3 

Task 1 reat 
15 


Figure 2-1. Sample LRN Priority Level Attachments 
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Starting with the tasks at the top of the figure, the operator's console by 
convention uses LRN 0. Following it are two communications device drivers, each 
with a separate LRN and sharing one level with LRN 6. VIP 2 has different LRN's 
for input and output, but it must have the same level. This allows a different 
configuration to use different devices without changing the program. Further 
down, two diskettes have unique level assignments, since peripheral devices 
cannot share a level. Level 9 is unused. Application tasks can share a level, 
and tasks 2 and 3 share level 15. Task 1 can be initiated by using LRN 10 or 
LRN 13, both referring to level 14. Although it might appear otherwise, the 
order of the task-LRN association is almost arbitrary. Levels 0 through 4 are 
dedicated assignments that do not require CLM statements. Level 5 though not 
attached to a LRN must be specified using the CLM COMM command. 


ATTACHING LRN's TO LEVELS 


The CLM ATLRN command is used to attach one LRN to one level. The DEVICE 
command does the same for peripheral devices. Each communications device has a 
unique command. An example of the commands used to specify the relationship 


illustrated in Figure 2-1 is given in Figure 2-2, 


OIM 0,13 

COMM 5 Communication Interrupt Level 5 
DEVICE KSR,0,13,xX'0500' Operator's Console Level 13 
TTY 1,8,X‘'FD80' Remote TTY Level 8 

VIP 2,8,X'FCOO' Remote VIP Level 8 


DEVICE FCD,3,6,X'1280' Cartridge disk (fixed) Level 6 
DEVICE RCD,14,6,X'1280',3 Cartridge disk (removable) Level 6 


VIP 4,7,X'FC80' Remote VIP input Level 7 
EQLRN Day. Remote VIP output Level 7 
TTY 6,8,X'FDOO' Remote TTY Level 8 


Diskette Level 10 
Diskette Level 11 


Line printer Level 12 


DEVICE DSK,7,10,X'1300' 
DEVICE DSK,8,11,X'1380' 
DEVICE LPT,9,12,X'0580' 


ATLRN 10,14 Task 1 Level 14 
ATLRN ie Task 2 Level 15 
EQLRN L245 Task 3 Level 15 
ATLRN 13,14 Task 4 Level 14 


e 
° 
® 


Figure 2-2. Sample Statements Attaching LRN's to Levels 
The cartridge disk used in the example has a fixed and a removable disk, 


and needs two DEVICE commands. The parameter "3" is required to cross reference 


the previous disk DEVICE command LRN. 
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The EQLRN command is used when a new LRN has the same level as another LRN. 
For example: 


ATLRN 11,15 
EQLRN 12,15 


The ATLRN with an RCT-size parameter enables you to specify another RCT for a 
level. This feature could be used to create an RCT for a nonstandard device. 
The program would then have to initialize the RCT with data that the CLM normally 


enters from the CLM Command parameters; e.g., channel number, modem. 


None of the statements in Figure 2-2 will cause execution to start after 
loading. To start execution immediately after loading, the TASK command must be 
used with the fourth parameter set to YACT. If TESTOl (a task) with LRN 10 were 
to be activated after loading, the TASK command would be: 


TASK TEST01,10,14,YACT 


To have task A request task B for initiation, task A calls Task Manage- 
ment's "request" routine, and passes it the address of task control block (tcb) 
containing task B's start address and LRN. The tcb is built and initialized by 
the calling task, task A. If more than one task is to be initiated at the same 
priority level, the first task requested is the first one to be executed, with- 
out interruption from other tasks at the same level. The LRN used in the call 
to the "request" routine can be attached to a level during configuration either 
by using the ATLRN or TASK commands. However, if a task is to be executed 


immediately after loading, it must be def.ied in a TASK command. 


An alternate means for requesting a task can be used when the task is to 
have exclusive use of a level. Instead of obtaining a start address from the 
tcb, Task Management uses the B5-register contents of the interrupt save area 
(ISA) of the priority level of the requested task. A bit set in the tcb by the 
calling task indicates to the Task Manager whether to use a start address in the 
tcb or ISA. To initially set the B5-register to a desired task start address, 
the TASK command must be used. CLM takes the start address given in the command 
and places it in the B5-register of the ISA. 


If a task, after it terminates, is to be called again using the address in 
the ISA, the terminating task must contain a terminating code sequence that | 
permits the B5-register in the ISA to be restored to the desired start address. 


Such a code sequence of a terminating task is given below. 
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A LDV $R1,=130 
A+l LNJ $B5,<ZXTERM 


A+2 (first instruction of task being terminated) 


The context of the level is saved in the ISA whenever a task terminates at a 
level. In the above terminating code sequence, the B5-register contains the 
address A+2, which is the desired start address of the task. 


Input and Output Drivers 


The input/output operations in your application are handled by software 
components called drivers (for conventional peripheral devices) or line-type 
processors (for communications devices). These components perform the following 
general functions: 

e Initiate I/O operations on individual devices 

e Report errors and status information 

e Monitor timing to detect device failure or inactivity 

e Perform limited editing of transferred information 
See the Executive and Input/Output manual for descriptions of the drivers and 


the control structures they use. 


Honeywell supplies device drivers in both load and object module form. The 
names and sizes of the driver load modules are given in Table 2-4. The procedure 
for linking object module device drivers is described in Appendix B of this 


manual. 


A Honeywell-supplied driver is implicitly loaded when CLM processes a 
DEVICE command. The DEVICE command provides the logical resource number and the 
priority level for the specified device. Similarly, the line-type processors 
are implicitly invoked when the appropriate communications device command (TTY, 


VIP, BSC) is processed. 


If you write your own device driver, implicit invocation does not occur, 
and in order to include the module in CLM's load list, you must include an 
explicit ADMOD command in the configuration command file that builds your appli- 
cation. Furthermore, if your device driver requires nonstandard commands and 
parameters, you must provide the interpretive routines that build the control 


structures required by your driver as extensions to the cim.? 


The Honeywell-supplied drivers and line-type processors are reentrant, so 


that only one copy of the driver appears in the final configuration. 


: 
“Consult the current Release Bulletin for details about CLM extensions. 
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Memory Usage Considerations 


The memory area used by an online application consists of hardware-dedicated 
locations, data structure areas, load module residence areas, buffer and loader 
areas, and areas occupied by the symbol table and the CIM on a transitional 
basis. The total size of these areas determines the memory size requirements of 
an application. 


NOTE: In the descriptions that follow, all memory locations are 
specified in hexadecimal notation, unless otherwise indicated. 


HARDWARE DEDICATED LOCATIONS 


Low memory, from location 0 through location OOBF, is reserved for BES use. 
Among the indicators and pointers stored in this area are the trap save area 
pointer (word 0010), clock information (words 0014, 0015, and 0016), the level 
activity indicators (words 0020 through 0023), the trap vectors (words 0052 
through 007F), and the interrupt vectors (words 0080 through OOBF). A detailed 
memory layout and explanation of contents of the hardware-dedicated locations 


appears in the Executive and Input/Output manual. 


DATA STRUCTURE AREAS 


immediately above the hardware-dedicated locations is the data structure 
area. During the configuration process, the CLM builds the data structures 
required by the online application in this area of memory. Using the informa- 
tion supplied in its commands, the CLM determines the sizes of tables and save 
areas, constructs the framework of various tables, and inserts into those tables 
the information that is available at the time. The data structure area begins 
at location 00C0O and extends as far as necessary to accommodate the required 


structures. 
Figure 2-3 illustrates the layout and contents of memory. 


OVERLAY PLANNING 


The overlay technique allows you to economize on memory by using a given 
portion of it over and over again; it also forces you to think critically about 
the nature of the solutions to your application problems, and the order in 
which those solutions are achieved. 

The Overlay Loader consists of a set of reentrant service routines that 
provide the basic capabilities required for loading and starting overlay code. 


(See the Executive and Input/Output manual for details.) 


The Overlay Loader resides in memory during application execution; it con- 
trols overlay processing by using an overlay file and a set of data structures 
that were created by CLM as a result of information in the bound unit (root and 


overlay segments) produced by the Linker. 


2-19 AU49 


HIGH MEMORY 


—~«———~ END OF LOADER 


LOADER ~«e— ~ HIGH MEMORY ADDRESS SHMA 


LOADER 
EXTENSIONS 
START OF LOADER EXTENSIONS 


$< << $ $< ie 


END OF LAST LOAD MODULE +1 


en ere 


LOAD 
MODULES 


START OF FIRST LOAD MODULE 


— CC rrr 


SYSTEM 
DATA 
AREA 


—«—— POINTER (RESERVED) 
~«—— HIGH MEMORY ADDRESS (<HMA) FROM SYS COMMAND 
~«—— POINTER TO LAST LOAD MODULE #1 
LOAD <«—— hilrn FROM SYS COMMAND 
COMPLETION | ~“——— POINTER TO WORD BEFORE CLOCK QUEUES (ZXCMGR) 
DATA ~«—— POINTER TO START OF LRT 
~*——- HMA OF LOADER 
~«<—— POINTER TO START OF QUEUE HEADER 
~<—— POINTER TO FIRST LOAD MODULE 


DEDICATED 
LOCATION 


LOW MEMORY 


RESIDUE AREA = HIMEM — LOCE 


Figure 2-3. Memory Data Structures 
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Establishing Overlay Areas 


The items and locations used in the following discussion are shown in 


Figure 2-3. 


Theoretically, all of memory above the system data area (LOCS) should be 
available for use by programs that execute as overlays. There are some limita- 


tions, however. 


Apart from the fact that the root module of a bound unit must be resident 
during execution, thus limiting the actual area that can be used by the overlays, 
there is a property of overlay code produced by the higher level language 
compilers, and even some types of code written in assembly language that makes 
unrestricted use of all available memory impossible. Such code is called 


"nonfloatable." (Refer to Program Development Tools manual for details.) 


Normally, CLM treats all overlays as if they were nonfloatable; that is, it 
loads them into memory in exactly the area from which they will eventually be 
executed. The total area required for a set of nonfloatable overlays is the 
area required by the largest nonfloatable overlay module. The first example 


below shows a bound unit that has two nonfloatable overlays. 


If the overlay code is floatable, that is, dynamically relocatable when it 
is reloaded for execution, the overlay does not contribute to the overall load 
space, and it is possible to use the area above the end of the last load module 
(LOCE) in which to position the floatable overlays. This is particularly 
important when LOCE and LOCX are nearly the same value; then floatable overlays 


can be executed in the area reserved by CLM during loading. 


Perhaps the simplest way to set aside space for floatable overlays is to 
incorporate the Buffer Manager in your configuration and request blocks of 


memory equal to the size of overlay code in the BUFSPACE command to CLM. 


Alternatively, the CLM residue above LOCE can be used by developing 
specific addresses in the root after all loading is complete based on informa- 
tion in the CLM-created "Load Completion Data Area" in Figure 2-3. The pointers 
to LOCE and the high memory address of the loader are useful for developing load 


addresses to position floatable overlays. 


Overlay Coding Conventions 


The use of overlay processing requires an understanding of the way in which 
root and overlay segments are defined for processing by the Linker, and the 


relationships between root and overlay segments. 
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Modules to be processed as overlays are identified as such when they are 
linked. The following Linker commands identify the root modules and overlays, 
and specify the position of overlays in relation to the root module. 

NAME - Identifies the root module. 

IST - Marks the location of initialization code in the root. 

OVLY - Names the overlay module. 

BASE - Positions the overlay module. 

In response to information placed in the load module by the Linker when it pro- 
cesses these commands, the CLM constructs a relative file containing the overlay 
modules; the root module remains memory resident. CLM also builds the data 
structures that the Overlay Loader uses to manipulate overlays during the execu- 
tion of the application. Refer to the Linker portion of the Program Development 


Tools manual for details about creation of bound units and symbol definitions. 


Example of Nonfloatable Overlays 


This example shows a root program, TCTEST, that has some initialization 
code labeled ISTTAG, and two overlays: MTCTESTO1, and TCTESTO02. The diagram 
below shows the relationship between the root program and the two overlays; the 
letters in the modules indicate symbols that are either defined (D) in a module, 


or referred to (R). 


When it is loaded, overlay TCTESTO1 is located at ISTTAG; overlay TCTESTO2 
is located at ISTTAG+100, as shown below. 


TCTEST TESTO1 


TESTO2 
The Linker commands to create the bound unit are: 

NAME TCTEST Name used in the ADMOD command. 

LINKN TCTEST Links root. 

EDEF W Defines symbol externally referred to from 
outside the bound unit (not shown). 

IST ISTTAG Defines initialization code and overlay 
position. 

OVLY TCTESTOL Names first overlay; Linker writes root to 
disk. 

BASE ISTTAG Indicates position of first overlay. 

LINKN TESTO1 Links first overlay. 
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4 


EDEF xX Defines externally referenced symbol. 


OVLY TCTESTO2 Names second overlay; Linker writes first 
overlay to disk. 


BASE ISTTAG+100 Indicates position of second overlay. 


LINKN TESTO2 Links second overlay. 
EDEF Y Defines externally referenced symbol. 
END Completes definition of bound unit; Linker 


writes second overlay to disk. 


Notice that only one IST command is used — only root segments may use 
initialization code. The Linker can satisfy the reference from the first over- 
lay to W in the root because the root is linked first. However, a reference to 
Y from TCTESTO1 would cause a CLM error hait — the Linker writes TCTESTOi to 
disk with Y as an unresolved symbol, and CLM will not write an overlay to its 


file if it contains an undefined symbol. 


A reference from an overlay to W in the root is legitimate because the 
Linker retains all symbol definitions not purged by subsequent BASE commands 
affecting the same area. References from the root to X and Y defined in the 
overlays require EDEF statements in the overlay command group because the CLM 
must resolve the references when these modules are loaded. (The Linker was 
unable to resolve the references before the root load module was written to 
disk.) 


The EDEF definition for W in the root module is superfluous for this 
example, but illustrates another requirement for symbol definition, namely that 
an EDEF statement is needed when a symbol is referred to from outside its own 


bound unit. 


When the application using the bound unit shown in the example above is 


configured, the CLM receives this ADMOD command: 
ADMOD filename:TCTEST ... 


As a result, the CLM will load the root segment and its initialization code into 
memory following any code loaded as a result of previous ADMOD statements. The 
initialization code beginning at ISTTAG is executed before loading the first 
overlay. Then, using the information specified in the BASE command for the 
first overlay, that segment is loaded. If the overlay has no undefined symbols, 
it will be written out to a temporary file. 


Finally, the second overlay is loaded starting at ISTTAG+100, and written 


out to the temporary file. The CLM continues to process command statements, 
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Example of Floatable Overlays 


This example illustrates a bound unit whose root has dedicated areas within 


it, and whose overlay segments are all floatable (dynamically relocatable). 


The Linker commands to create this bound unit are: 


NAME ABC Provides name to be used in the ADMOD 
command. 

LINKN A Links root segment. 

OVLY ABCO1 Names the first overlay; Linker writes 
root to disk. 

BASE Al Locates overlay. 

LINKN ABCOL Links first overlay. 

OVLY ABCO2 Names second overlay; Linker writes first 
overlay to disk. 

BASE Al Locates overlay. 

LINKN ABCO2 Links second overlay. 


OVLY ABCnn 


BASE Al 
LINKN ABCnn 
END 


The overlays in this example are all floatable, so that the code in the 
root and the overlays could include load addresses developed from the CLM- 


supplied pointers in low memory as described earlier. 


Note that the ADMOD command for ABC must be positioned in the CLM command 
sequence in such a way that the largest floatable overlay to be written out by 
CLM may be loaded into memory below location LOCX (Figure 2-3). This can be 
accomplished by having other ADMOD commands, whose modules occupy at least as 
much space as the largest ABC overlay, follow the ADMOD for ABC. 


After loading is completed, the overlays are brought into memory areas pre- 


viously occupied by CLM by calling the Overlay Loader. 
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The CLM determines the final size of a bound unit (and thereby the location 
where the next load module begins) based on the highest address occupied by 
either the root or one of its nonfloatable overlays. This means that the root 
alone in the floatable overlay example determines the bound unit size. If the 
root does not include overlay areas within it (e.g., by using a RESV assembly 


statement), those areas must be obtained in alternate ways. 


Care must be taken in source code to produce a floatable overlay. However, 
an overlay may inadvertently be coded (or later modified) so that it matches the 
definition of a floatable overlay. To prevent a change in CLM operation 
resulting from a nonfloatable overlay becoming floatable, the source code of the 
nonfloatable overlay could include a global reference to an address tag within 


that same source. 


How to Estimate Overlay File Size 


The CLM assumes that there is enough physically contiguous space in the 
relative file it uses for the application overlays. If this is not true, por- 
tions of the disk beyond the allocated file space will be destroyed. The CLM 
also assumes that the name of the relative file it will use to contain the over- 
lays is either OVERLAY, or the filename used in the AT0O3 command to the Command 


Processor. 


To estimate how many sectors should be allocated when using the utility 
initialize function, take these steps: 

1. Produce link maps for all overlay load members. 

2. Determine the number of words in the image text of each one. 


3. Divide the image text word total by the number of words per 
sector (64 for diskette; 128 for cartridge disk) to obtain the 
number of sectors for each overlcy. 


4, -Add the individual sector requirements together to get the total. 


5. Add in the Online Debug Program sector requirement (22 for disk- 
ette; 22 for cartridge disk), if needed. (This is always a good 
idea, because you may need the ODP later.) . 


It is important to note that each overlay begins on a sector boundary so 
that it may be read into memory (and written out by the CLM) as a single I/0 


transfer. This design minimizes overlay load time during execution. 


INITIALIZATION SUBROUTINES 


Initialization subroutines may or may not be required by every module. As 
you write the initialization code for your modules, you may want to use one or 
more Of the system-provided subroutines summarized in Table 2-7. These subrou- 
tines use the standard register conventions that you will also use when you 


write your subroutines. 
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Table 2-7. Register Use by System Initialization Subroutines 


eee ——TT—TK@&==—@[==aT—e——qqK—lElEEE~EoI~Io~I~—~—————=—=—={_=_"_S=—X—X—X—X—X——_—=—=—«X—S<——X—X_—_—=—<—<£==£=£_=_=—=—<—<F§_—<—<$_€_—_=_==_—= 


ZGF INU Find a symbol in Pointer to 
symbol list start of symbol Aeneees 
name 
found 
ZGDEFU dL. Define a symbol Rl - 0 = Address Rl - 0 = No error 
definition LF = Symbol 
Value = Value already defined 
definition 91-2 Wark Aven 
R2 - Definition overlap 
value 
Definition 
address 
ZGREFU 2 Refer to a symbol} Rl - O = Address Rl - 0 = No error 


reference 21 = Work area 


overlap 


Value = Value 
reference 


Pointer to 
location refer- 
red to 


These registers have the same values for all functions: 
R3 - function code; B4 - pointer to the start of the symbol 
name; B5 —- return address. 


Other registers used by these subroutines: R4, R7, B2, B7, R6. 


Initialization is performed immediately after the loading of a module is 


completed. Each initialization subroutine is entered via the LNJ instruction 
using register B5 for the return address. The address of the parameter list is 
loaded into register B4, the parameter list itself is defined in the initializa- 


tion subroutine table described below. 


Errors occurring during initialization are fatal errors; loading cannot be 
continued. Error information is returned in register Rl; CLM moves the contents 
of Rl to R2 and places the 1304 halt code into Rl. If the content of register 


Rl is zero, the operation was successful. 


The initialization subroutine table identifies the subroutines that are to 
be executed when the module has been loaded. It has the following format: 
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label DC 0 next load displacement 


RESV SAF, 0 RFU 

DC <name first initialization subroutine 

DC value parameter a for first subroutine 
DC value parameter 2 

DC <name second initialization subroutine 
DC value parameter ay for second subroutine 
DC value parameter 2 

RESV SAF , 0 sentinel, end of IST 


Entries must be included in the initialization subroutine table for each 
subroutine required for a load module. The "label" in the first statement of 
the format example must be defined in an IST command to the Linker. The location 
at "label" is the point at which the next module will be loaded when the initial- 


ization is completed. Normally, the value declared at "label" is zero. 


During the CLM loading phase, the base address for loading the next load 
module is formed by using the address of the first word of the current load 
module's initialization subroutine table (IST in the example) plus the displace- 
ment value contained in that word. When the displacement is nonzero, the next 
module loads below (for a negative displacement) or above (for a positive 


displacement) the IST start address. 


Communications Planning 


The Communications functions of BES software have been designed in such a 
way as to make them as easy to use as any other peripheral device. Your inter- 
action with the Communications software occurs through the physical I/O inter- 
face. Using the Configuration Load Manager, you assign a logical resource 
number to the various Communications devices. Then, in your application program, 
using a standard call to the Executive, and providing a standard control struc- 
ture (an IORB) in which to pass parameters, you request a transaction with a 
particular communications resource. Your request is then handled by the 
Communications software, and you need not be concerned with the details of 
Communications procedure. See the IORB information in the Executive and Input/ 
Output manual for details about the standard control structures and function 


codes for Communications devices. 


PRIORITY LEVEL REQUIREMENTS FOR COMMUNICATIONS 


Although both peripheral and Communications devices share a common inter- 
face, they have different priority level requirements. Peripheral devices such 
as card readers, disks, and printers are asSigned one device to a level. Com- 
munications devices, however, require one dedicated level (specified in the COMM 


command) that is reserved for the processing of Communications interrupts, and 
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must be the highest priority level assigned to a Communications function. 
Additionally, any number of priority levels may be shared among Communications 
devices (not with any other device types); these priority levels must be lower 


(higher level numbers) than the level specified in the COMM command. 


REQUESTING COMMUNICATIONS FUNCTIONS 


When you request a transaction with a communications resource, you must 
specify the logical function in the request block that you provide with each 


request. 


There are five logical functions: connect, read, write, wait-on-line, and 
disconnect. The connect must precede other requests, because Communications 
resources are configured in a disconnected state. The sequence that would occur 
is as follows: 


1. Set up an IORB with the function code for a connect request, and 
call the physical I/O interface. 


2. Once the connection is made, you supply the appropriate request 
blocks for the functions that your application will perform, and 
do the reads, writes, and/or wait-on-line operations required by 
the program's logic. 


3. When the program finishes processing, you supply a request block 
with the disconnect function code, and call the physical I/0 
interface to perform the function. 


The values that you provide for the various function codes are coded in the 
last four bits of word three (ZIRCT2) of the IORB that you supply in your 


application program. 


If your application is such that the program must: 


e Temporarily suppress the previously queued data request to or from 
a VIP or TTY, or 


e Signal a traffic direction change for a device (BSC) 
there is a means of disconnecting the resource logically while maintaining the 
physical line connection. This logical disconnection is accomplished when bit 
15 of the device-specific word of the IORB is set on; when this bit is zero, the 


physical line connection is discontinued. 


The Communications function codes (CONNECT and DISCONNECT) may be used with 
no effect if a program whose IORB's contain such codes were to be executed using 
noncommunications peripheral devices, thus the program is independent of the 


device types that may be in use. 
COBOL application programs can use the Communications facilities of BES 


software by the standard input/output verbs OPEN and CLOSE; these verbs evoke 


the Communications connect and disconnect functions, respectively. 
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BINARY SYNCHRONOUS COMMUNICATIONS (BSC 2780) 


This Communications protocol may be used in conjunction with an appropriate 
application program in the following ways: 
e IBM 2780 remote terminal emulator 


e File transmission for Level 6-to-Level 6 computers 


IBM 2780 Remote Terminal Emulation 


In this environment an application program would be structured to emulate 
the functions of the IBM 2780 remote terminal in a manner which is consistent 
with the features available on the host computer responsible for processing the 
submitted data. 


The features of BES2 BSC 2780 line protocol are described below. 


Level 6-to-Level 6 File Transmission 


In this environment an application program could be developed to transmit 
both binary and ASCII data, in records of any size, between two Level 6 


computers. 


The support of the character sets (whether ASCII or EBCDIC) is restricted 
to the line protocol handler providing the control characters in the appropriate 


character set. 


The character set of the text portion of the data is totally the responsi- 


bility of the application program. 


In transparent EBCDIC, the line protocol handler will assume total responsi- 
bility for inserting and removing the line protocol escape character (DLE) both 


in the header and in the text. 


Whether a transmission unit from Level 6 will contain a single record or 
two records may be managed by the application program in the following way: 


e Creation of single record transmission units requires that each 
write order be issued with the wait status specified in the IORB. 


e Creation of two-record transmission units requires that each write 
order be issued with the do-not-wait status specified in the IORB. 


In this situation, the application would do the necessary processing 
and issue another write order with the do-not-wait status specified 
in the IORB. The process continues, the application program pro- 
cesses in a totally independent manner, without regard for the 
activity on the Communications line until the application program's 
write buffers are filled. At this point, a wait on the first IORB 
is issued. When the application program resumes, it again does its 
processing, and issues another write order (do-not-wait). Then a 
wait on the second IORB is issued, and so on, 
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The packaging of the write requests into a transmission unit is done 
independently by the line protocol handler. A second record will be embedded in 
the transmission unit as long as the write request is issued before the last 
character of the previous write request has been transmitted over the Communica- 
tions line. As a practical matter, considering the comparative slowness of the 
communications line (maximum 1200 characters/second) with other resources 
(computer, peripherals, etc.), there is sufficient time to allow this free- 
wheeling process to work. 


If an application program is by convention to be prepared to handle the 
receipt of data from an application that transmits two records in a single 
transmission unit, then it is required that two read requests always be present 


at any time during which a transmission unit may be received. 


A basic characteristic of the BSC 2780 communications protocol is that it 
is nonconversational. That is, once the movement of data has been established 
between computers (i.e., from A to B), it is not possible to transmit from B to 
A until the entire quantity of data has been transmitted from A to B. Occa- 
Sionally, there may be a need to send an urgent preemptive message in the direc- 
tion contrary to the flow of information. This need is resolved by computer B 
issuing a disconnect request with the indicator set to abort all IORB's in the 
queue. Upon notification of this action being complete, it is now possible for 
the application program in computer B to issue a connect request followed by 


the write order for the urgent message. 


When computer A received the notification from computer B of the urgent 
preemptive need to send a message (signaled in BSC 2780 by the receipt of a 
reverse interrupt, RVI) it would so notify the application program via the 
attention interface, after dequeuing and posting all currently queued IORB's. 
The application program would then issue a receive order for the acceptance of 


the preemptive message. 


SECTION 3 
BUILDING 


The Configuration Load Manager (CLM) defines the application variables, 
sets up the required internal control structures, prepares a load list of the 
specified modules, and initiates the execution of the application, all in one 


continuous operation, 


Before executing the CLM, you must have already prepared the programs and 
files to be used in the application. This preparation includes compiling (or 
assembling) the programs, linking them into one or more load modules, and pre- 


allocating space for all output files to be used. 


During the configuration phase, CLM accepts the commands that direct its 
operation. In addition to specifying system characteristics such as memory size 
and processor type, the commands processed by CLM also set priority levels for 
tasks, assign logical resource numbers, and direct the construction of a load 


module list containing the names of all the modules to be loaded for execution. 


Once the configuration phase is completed, the modules named in the load 
module list are loaded by the particular loader then in use. Any unresolved 
references among the modules are resolved at this time. As each module is 


loaded, it is initialized before the next module is loaded. 


After the last module is loaded and initialized, control is transferred to 


the active task having the highest priority. Execution then begins. 


PREPARING TO USE CLM 


Since CLM allows an application to be run as a single load-and-go operation, 
all files to be used for output by the application should be preallocated, and 
all modules, both Executive as well as user-written modules, should be linked 
before the CLM is loaded into memory. These preliminary processes are described 
in the appropriate manuals, and illustrated in Figure 3-l. The process of 
building an online application falls naturally into discrete steps. The fol- 
lowing pages describe the process and refer you to the pertinent manuals for 


complete details. 


3-1 AU49 


STAGE 13 


STAGE 2 


STAGE 3 


STAGE 4 


STAGE 5 


STAGE 6 


ALLOCATE FILES 
FOR SYSTEM 


AND APPLICATION 
PROGRAM OUTPUT 


CoA ie SO vnCe eeuGE 
MODULE 
DISKETTE SRyEE 
- EDIT SOURCE 
if FILES AND SOURCE 
REWRITE ON MODULE(S) 
| -e- DISKETTE 


Bs cee cee ee ee ee od 


ASSEMBLE OR 
COMPILE 
SOURCE 
PROGRAMS 


ASSEMBLY OR 


COMPILATION 
LISTING 


OBJECT 
corRe MODULE(S) 
SOURCE 
PROGRAM 
ADDITIONAL Kani 
OBJECT = GHiEGE LOAD 
MODULES moouLes MODULE(S) 
7 
/ 
7 
ADDITIONAL CONFIGURE, 
USER-WRITTEN LOAD AND APPLICATION 
AND GCOS/BES START OUTPUT 
LOAD MODULES ONLINE 
APPLICATION 


CLM COMMANDS 
! 


ee | 


“ 
‘\ 
APPLICATION 
OUTPUT 
== 


f 
i 
L 


Figure 3-1. Building an Online Application - Process Diagram 
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Output File Preallocation (Stage 1) 


Figure 3-l summarizes the file requirements for all the following stages in 
the application development process. File space is allocated by Utility Set l. 
(See the Utility Programs manual.) Some of the files your application uses must 
be relative files to receive either the output data from the application, or, if 


you are using overlays, the overlay file written by CLM. 


The file to accommodate any overlays that CLM writes out in the process of 
application configuration must be a single extent, relative file large enough to 
hold all the application's overlays. If the overlay version of the Online Debug 
Program is being used, the overlay file must provide 50 diskette sectors, or 25 


disk sectors in addition to the space required for other overlays. 


Files that are intended to receive source, object, or load modules must be 
initialized after space is allocated, to organize those files as partitioned 


files capable of accommodating individually accessible members. 


If you plan to use the Online Debug Program with predefined command lines 
stored on disk, you must preallocate a relative file named DEBUG.WORK containing 


22 diskette sectors, or cartridge disk sectors for use by this program. 


If your application program produces an output file that is intended for 
printing by a print utility, either immediately, or at a later time, the first 


byte of each record to be printed must contain printer control information. 


Source Module Creation and Editing (Stages 2 and 3) 


Partitioned files containing source text members are created on disk from 
punched card files using Utility Set 2. nce created, these source files are 
then usable by the Editor, for correction or addition of text, or they may serve 
as input to the Assembler or to the FORTRAN or COBOL Compiler. (See Program 


Development Tools manual.) 
Stage 2 is mandatory if source programs are punched on cards; it may be 
omitted entirely if the source programs are short enough to be entered through 


the keyboard as input to the Editor. 


Stage 3 is optional. It is possible to go directly from creating a source 
file on disk to the Assembler/Compiler phase. 
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Object Module Creation (Stage 4) 


The creation of object modules is the function of three system programs: 
the Assembler for programs written in assembly language; the FORTRAN Compiler, 
and the COBOL Compiler, for programs written in FORTRAN or COBOL source language. 
In addition to object modules produced on disk, the Assembler and both compilers 
produce source listings with diagnostic messages that refer to the various 
syntactical errors encountered in the processing of the source language state- 


ments, 


Once the source code is free of syntax errors, and has been reassembled or 


recompiled, the program is ready to be processed by the Linker in the next phase. 


Load Module Creation (Stage 5) 


The preparation of load modules for use in online applications requires 
special attention to the ordering of permanent code and the initialization code 


for particular load modules, and to the handling of externally defined symbols. 


LINKING ORDER FOR CODE TEXT 


One or more object modules may be linked to form a load module. The order 
in which modules are linked is significant in the following situations: 

e Modules being linked require initialization code, 

e Modules being linked will be executed as overlays. 
Load modules that require initialization code must have all permanent code 
linked before the initialization code for the load module. This is because, 
during the loading phase in the operation of CLM, successive modules are loaded 
in such a way that once the initialization code for a module is executed, it is 
replaced by the permanent code of the next module. Figure 3-2 shows the memory 
layout of a module and its initialization routines, and indicates the starting 


location for loading the next module once the initialization has been performed. 


EXTERNALLY DEFINED SYMBOLS 


An application load module may have valid undefined symbols at the time it 
is linked, such as a call to an Executive subroutine. The CLM resolves these 
references as it loads the Executive Modules specified in the ADMOD, DEVICE, and 
Communications line type processor commands, and analyzes the ELOC, EVAL, TRAP 
and DEVICE commands. 


Any symbol that may be referred to by other load modules or by the CLM, and 
not defined by CLM itself, must be identified in an EDEF statement at the time 
the module is linked. (See the Program Development Tools manual for Linker 


information, ) 
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Figure 3-2. Current Load Module Memory Layout 


In assembly language, locations or values that are referred to by modules 
other than the one in which they are defined, are identified in an XDEF state- 
ment; when the defining module is linked, the label(s) made available for 
external reference by these XDEF statements are declared in a Linker EDEF state- 


ment if CLM must resolve references to these labels in other modules. 


During configuration, the CLM must be able to resolve all references either 
from information provided to it in a symbol table from the Linker, or from the 
symbol table CLM itself constructs from the command information submitted to it. 
The unresolved symbols encountered by CLM during execution cause a load error 
(1341 — see the Operator's Guide) followed by a halt; at your discretion, you 
can ignore these errors and continue processing. However, there are load errors 
that prevent continued execution of CLM: the occurrence of an undefined symbol 


in an overlay module (135B — see the Operator's Guide). 


There are several CLM command parameters that require Linker EDEF state- 
ments: the start address in a TASK command; the ppt-label and space-name in the 
BUFSPACE command; the handler-name in a TRAP command; the label parameter of a 
DEVICE, TTY, VIP, or BSC command if the label specifies a user-defined routine 


and is not the default label, ZIATTN for LRN 0. 
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Summary Of Load Module Preparation 


These are the steps involved in the preparation of load modules prior to 
configuring an online application: 

e Collect the object modules that make up the permanent code. 

e Collect the system initialization modules to be used. 


e Write and assemble the user-written initialization code and the 
initialization subroutine table. 


e Run the Linker to produce a load module in the format described in 
Figure 3-2, Note that the initialization subroutine table is always 
linked immediately following the permanent code text. It is at this 
point in the process that the Linker EDEF command is used to specify 
all externally-referenced symbols. 


USING THE CONFIGURATION LOAD MANAGER (STAGE 6) 


The CLM and its extensions are the BES software components you use to 


configure an online application. 


CLM consists of four functional groups of modules that interpret the com- 
mands in which you have specified the system variables, devices, and load modules 
that constitute the configured application. Of these functional groups, one, 
the CLM nucleus is required for configuring all applications; the other three 


are optional extensions that interpret particular configuration commands. 


Depending on the memory size of your system, the optional modules may be 
resident throughout the operation of CLM, or, as with an 8K system, the CLM 
extensions must be executed as overlays. Table 3-1 summarizes the functional 


groups and indicates the commands that are interpreted by each. 


How to Include Optional CLM Extensions 


The CLM extensions that interpret the File and Buffer Management, and 
Communications commands are included by specifying the appropriate information 
in a LACT command for each extension. The LACT command contains a parameter to 


indicate that an extension is to be executed as an overlay. (See Appendix A.) 


The following example shows the LACT commands for a communications applica- 
tion whose devices are accessed through the File Manager, and that will require 


device definitions that include the File Manager DEVFILE command. 


LACT CLMCOMM: COMM 
LACT PROGFILE:CLMFIL 


The channel number is the same as that from which CLM was loaded, the work areas 


for both sets of modules will not be shared, and both sets of interpretive 


modules will be resident rather than overlays. 
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Table 3-1. CLM Functional Groups, Component Modules and Related Commands 


Functional Group sae Ail 
(filename :membername) Component Modules Commands Processed 


PROGFILE: CLM CLM Nucleus 
(required) 


CLM SYS 
CLM2 OIM 
CLMST1 TSA 
DSCLMST1 CLOCK 
CSCLMST1 DATE 
CLMST2 TASK 
DSCLMST2 DEVICE 


PROGFILE:CLMFIL File Manager Extensions 


(optional) 


CLMFIL FILMGR DEVFILE 
DSCLMFIL ATFILE FMDISK 
CSCLMFIL 


PROGFILE: CLMBUF Buffer Manager Extensions 
(optional ) 


CLMBUF BUF SPACE 
DSCLMBUF 
CSCLMBUF 

CLMCOMM : COMM Communications Extensions 

(optional) | COMM COMM - BSC 
DSCOMM TTY MODEM 
CSCOMM VIP LTPDEF 

LTPn STATION 


PAs specified in the LACT command 


If the extensions are executed as overlays, it is not necessary, but more 
efficient to group the configuration commands in the same order as the exten- 
sions were specified. The grouping of commands becomes particularly important 
if your application is configured from a serial device. (See "Loading From 


Paper Tape," discussed later in this section.) 


After the CLM nucleus. has been loaded, the only commands that it will pro- 
cess are the LACT and IOS commands, until an ELACT command is read. In fact, 
even if you do not add any of the CLM extensions, an ELACT command must be 
issued so that CIM may begin processing the other application configuration 


commands. 


To summarize; the optional CLM extensions may be executed as resident 
modules, or they may be executed as overlays; in an 8K environment the exten- 
sions must be executed as overlays; unlike the execution of application program 
overlays that require the availability of a disk, CLM extension overlays have no 


such requirement. 
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Application Configuration and Loading 


You can load CLM and configure your application from disk or paper tape, 
either as a nonstop procedure (disk only), or a load-and-halt operation; you 
can use, but do not need, an operator's console. Specific operating procedures 
for all methods are described in the Operator's Guide, and discussed briefly in 


the following pages. 


NONSTOP APPLICATION LOADING 


The nonstop loading procedure is based on a preset bootstrap record created 
by the Bootstrap Generator utility program. The elements of this record are 


described in Table 3-2. (For details, see the Utility Programs manual.) 


Table 3-2. Bootstrap Record for Nonstop CLM Loading 


DFT N 
BTHLT N 


1FFF (8K) 
3FFF (16K) 
JFFF (32K) 
FFFF (64K) 


0 
0400 (disk) 

; (paper tape) 
PROGFILE 
CLM 


XXxx? (8K) 
XXXX (16K) 
XXXX (32K) ( 
XXXX (64K) 


HMA (high memory address) 


KSR 
LDCHN (load channel) 


FILE 
MEMBER 


PROGFILE 
CMDPRC 


REL (relocation factor) 


N 


Acee Release Bulletin for exact values 


The nonstop loading procedure is usable only when your load modules are on 


disk; no operator's console is needed. 


The file requirements for nonstop loading from disk are these: the CLM 
command input file (CLMCI) must be on disk. If you are running your application 
program as overlays, you must preallocate a relative file for CLM to use when it 


writes out the overlays. 


If you are configuring a communications application, then in addition to 


PROGFILE, your disk should contain CLMCOMM, 
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The Bootstrap Generator Utility program is executed to place the preset 
bootstrap record on the disk. The parameters for the utility, assuming a 16K 


system, are: 
N, ,3FFF,0,0400,,CLM, 3480 


When this record is on the disk, and all the load modules needed by the 
application are available, you are ready to carry out the loading procedure. 
You press: Stop, Clear, Load, and Execute; there will be a pause while the QLT 
(Quality Logic Test) is performed, then press Execute again, and application 


configuration is underway and needs no further intervention. 


LOADING FROM DISK USING THE COMMAND PROCESSOR 


This method involves minimal operator intervention, but allows the command 
input file to the CLM to be reassigned from the KSR to either a disk on a dif- 
ferent channel, or with a nondefault member name, or card file. The method also 
requires a preset bootstrap record, but this time the default values for the 
file and member entries in Table 3-2 can be taken; those entries are PROGFILE 


and CMDPRC, respectively. 


The parameters for the Bootstrap Generator utility program, again assuming 


a 16K system are: 
N, ,3FFF,;,777,3480 


When you are ready to carry out the loading procedure, press: Stop, Clear, 
Load, and Execute; after the QLT has executed, again press Execute. The Command 
Processor indicates its availability by printing a C? on the console; at this 
point you can use the EX command to assign a command input file that loads CLM 
with appropriate attachments for configuring your application. No further 


operator intervention is needed. 


LOAD AND HALT PROCEDURES FOR DISK 


These procedures can be carried out using either an operator's console or 


the control panel if no console is available. Both methods are described below. 


Loading From Disk With an Operator's Console 


When the load device is a disk and an operator's console is available, CLM 
is loaded using the Command Processor in conjunction with the Disk Loader. The 
Command Processor accepts control information through the console to establish 
the environment for the execution of the CLM. (See the Program Development 


Tools manual for a description of the Command Processor.) 
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The commands entered through the console specify a relocation factor, and 
whether a halt should occur after CLM is loaded (e.g., to allow the mounting of 
a new disk). In addition, the commands specify the command input file name; the 
overlay file name, if necessary; and the device and channel number from which 


the CLM commands will be entered. 


The last Command Processor command causes the CLM to be loaded. If no halt 
was specified, the CLM starts executing as soon as it is loaded. Otherwise, the 


system halts, allowing you to perform any necessary actions before continuing. 


Loading From Disk Without an Operator's Console 


In this method, no Command Processor is usable. If the load parameters 
vary from load to load, they can be entered through the control panel, with a 


bootstrap record on disk set up to halt as described below. 


The bootstrap record parameters BTHLT and LDHLT are, in this case, set to 


When the bootstrap record has been written on the disk, you can begin the 
loading procedure. Make sure that your disk is on the device that is connected 
to the default bootstrap channel (0400, ¢)-. Press: Stop, Clear, Load, Execute 


(QLT pause), Execute. 


When the 1601 halt occurs, press Stop, and then you can enter the reloca- 
tion factor into register B2, the HMA into B3, and the loading channel number 


into R2, Then press Ready and Execute. 


When the 1603 halt occurs, you can choose the CLM command input device and 
channel number by: pressing Stop, entering the channel number of the command 
input device into R6, and the device type into R7. The device types are: 0040 
for a card reader, 0080 for a disk. Press Ready and Execute. Control is now 


turned over to CLM and configuration of the application proceeds. 


LOADING FROM PAPER TAPE 


The only procedure available for this medium is a load and halt procedure 
because the command file for CLM cannot be entered from paper tape. You can 
minimize halting by setting most values in the bootstrap record, but the LDHLT 
parameter should be given a value of Y so that you can assign the command file 


to the appropriate device. 


Since paper tape is a serial medium, all elements must appear in the order 
in which they are to be used. The first element on the tape must be the boot- 
strap record; when the Bootstrap Generator program is executed to create the 


bootstrap record, the utility also places the next required module on the tape, 
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namely, the Paper Tape Loader. Table 3-3 shows the order of CLM modules 
required for paper tape loading. See the Operator's Guide for complete details 


about all loading procedures. 


Table 3-3. CLM Load Module Order for Paper Tape 


Memory Size 


HMA=1FFF (8K) HMA>1FFF (8K) 


CLM CLM 

CLM2 CLM2’ 
DSCLMST1 DSCLMST1 
DSCLMST2 DSCLMST2 
DscomM” DScoMM? 
DSCLMFIL™ DSCLMFIL® 
DSCLMBUF* DSCLMBUF* 
cimst1° CLMST1 
CLMST2 CSCLMST1 
comm" CLMST2 
CLMFIL® comm® 
CLMBUF* CLMFIL® 
CSCLMST1 cscomm® 
CSCOMM™ CSCLMFIL® 
CSCLMFIL* CLMBUF” 


CSCLMBUF@ CSCLMBUF® 


“rhese modules are included 
only if the appropriate LACT 
commands are issued. 

Pvodules beginring with this 
one are loaded as needed, and 
in order of LACT command 
submission when memory size 
is 8K. The above list 
assumes that the LACT com- 
mands were issued for COMM, 
CLMFIL, and CLMBUF in that 
order; consequently, con- 


figuration commands should be 
issued in the same order. 
Also, for 8K systems, the C$ 
modules will be loaded after 
the QUIT command is pro- 
cessed. 


If HMA is greater than 8K, 
all CLM modules will be 
loaded before any system con- 
figuration commands are 
requested, so there is no 
necessity to group these com- 
mands in this case. 
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Building a CLM Command File 


The order of command submission to the CLM depends on the type of applica- 
tion being configured. If, for example, you are including one or more of the 
CLM extensions, then the LACT commands are presented first, followed by an ELACT 
command. If no extensions are included, the ELACT command must be issued so that 


the CLM can begin to accept system configuration commands. 


As to the submission order of the system configuration commands themselves, 
several factors have an effect upon what the final order should be: memory size 
in combination with disk availability, the nature of the loading medium, and the 


characteristics of the modules that make up the application. 


As mentioned earlier under "How to Include Optional CLM Extensions," running 
CLM extensions as overlays is mandatory for 8K systems. Similarly, if memory 
size is limited, and you are running your own programs as overlays, then the 
order in which the ADMOD commands are submitted could be important if references 


are made from one bound unit to another. 


The nature of the loading medium can affect the grouping of commands as 


described previously, under "Loading From Paper Tape." 


Finally, the characteristics of the application modules themselves must be 
considered when you are designing your command file. For example, if you are 
configuring an application that contains communications software, it is advisable 
to issue the Communications commands to the CLM early in the process. The reason 
for this is that the line-type processor modules have extensive initialization 
code which loads the RAM portion of the MLCP, so that starting the configuration 
procedure with the Communications commands allows you to use the area occupied 
by this initialization code for permanent modules loaded later in the process. 
Whereas, if you wait to bring in the Communications modules until later in the 
process, you may either waste space, or worse still, you may have to begin the 
configuration process over again because there was not enough space left for the 


initialization code to execute, 


Similarly, CLM requires space for loading and writing floatable overlays to 
disk that is usable by permanent code that is subsequently loaded. You should 
consider loading programs that have floatable overlays early in the configura- 


tion process. 


Apart from the actual order of the commands in the command file, the fol- 


lowing facts should be noted. 
Any device that will be accessed through the File Manager requires a 


DEVFILE command; the DEVFILE command must be issued after the corresponding 
DEVICE, TTY, BSC, or VIP command. 
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An error results if the OIM command is omitted from the CLM command file 
because some system services may use the TYPR facility even if user programs do 


not. 


The CLM command file should begin with a SYS command unless all the default 


values are taken, and it must end with a QUIT command. 


The command set for CLM is described in Table A-1l; the definitions for all 


commands and their parameters are also found in Appendix A. 


CLM Action During Loading 


When the QUIT command is processed, the data structures are created ina 
nondedicated area of memory. Figure 3-3 shows how memory looks before the 


loading phase begins. 


When the loader is given control, it obtains the name of the first load 
module to be loaded from the load module list constructed by CLM. The first 
module is loaded beginning at a location just above that occupied by the system 
data structures. After the loading of each module is complete, control is given 


to the initialization subroutines of the module, 


At this point, if the module is a root module with overlays, the overlays 
are loaded, and written out to the overlay file. Figure 3-4 shows a memory 


layout after the loading process is completed. 


If the space name parameter of the BUFSPACE command is not given a value, 
the buffer area is obtained from the load residue space, which includes the area 
from the end of the last load module, through the value of the himem parameter 
in the SYS command. If the default value of himem is taken, the loader is 
included in the load residue area and could be overwritten by information put 
into buffers. Figure 3-5 shows how memory looks during application execution 
when the value of himem was not changed to protect the loader. 
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Figure 3-3. Memory Layout During Configuration 
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Figure 3-4. Memory Layout After Loading 
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Figure 3-5. 
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STARTING AN ONLINE APPLICATION 


It is important to understand how the starting point of an application is 
conveyed to the CLM, because you must take specific steps while creating applica- 


tion load modules to ensure that the CLM can identify the desired start address. 


Specifically, the CLM TASK command allows a task associated with a priority 
level to be started at a labeled address when the application is loaded. This 
start address label must be declared in a Linker EDEF statement when the load 
module containing the task is created. If an application has more than one task 
(each on a different priority level) to be started, multiple TASK and EDEF 
statements can be used. The EDEF's may be in the same or in different load 
modules. 


The EDEF command is used on behalf of assembly, FORTRAN, and COBOL language 
programs to define start labels to the CLM. Any label may be used in an assembly 


language program. 


For FORTRAN main programs, the label is either: 


e The “progname”™ used in a PROGRAM source statement in the main 
program, or 


e The compiler defauit iabel ZFMAIN* for a main program that does not 
contain a PROGRAM source statement. 


Note that a PROGRAM statement is required in main programs if multiple start 
labels are needed. 


The rules for defining the start addresses for load modules written in 


assembly, FORTRAN, and COBOL languages are summarized below. 


Assembly Language Start Address Definition 
e Start labels chosen are declared by XDEF statements to the 
Assembler, and EDEF statements to the Linker. 


e The label in each TASK command to the CLM matches the XDEF and EDEF 
definitions. 


FORTRAN Language Start Address Definition 


@e Start labels explicitly declared in PROGRAM source statements (or a 
ZFMAIN label created implicitly by the compiler) are declared in 
Linker EDEF statements. 


e The label in each TASK command to the CLM matches the EDEF defini- 
tion. 


this label is placed into the FORTRAN object (or source) output by the compiler 


using either an effective (or actual) XDEF Assembler control statement. 
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COBOL Language Start Address Definition 


e The program name in the PROGRAM-ID clause is declared in a Linker 
EDEF statement. 


e The label in a TASK statement must match the name in the EDEF 
definition. 


If the HLT parameter was coded on the QUIT command to the CLM, a halt will 


occur after the last load module has been loaded; if not, control will be given 


to the highest active priority level, and execution begins. 
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SECTION 4 
DEBUGGING 


This section provides some practical approaches that may be useful to you 
when debugging an online application. These suggestions are by no means all- 
encompassing, nor intended to restrict your ingenuity in uncovering and fixing 


a software difficulty in your program. 


USING THE ONLINE DEBUG PROGRAM 


BES provides an interactive debugging component, the Online Debug Program, 
(ODP) that supplies online patching and testing facilities for application pro- 


grams running under the BES Executive. 


There are two versions of the ODP, one runs as a series of overlays and re- 
quires the BES2 Executive; the other is memory resident and can execute under the 
control of either the BES1 or BES2 Executive. Both versions require an op- 
erator's console; an optional, preallocated relative disk file, DEBUG.WORK is 
used when delayed execution commands are executed. Table 4-1 summarizes the 


memory and work file space for ODP. 


Table 4-1. Memory and Work File Space Usage 


File Space Used 


Memory Needed Diskette Disk 
Module Name | BES Executive (Words) (Sectors) 


ZDBGL ZXEX02 or ZXEX03 2700 22 
ZDBG ZXEX03 only 1100 (overlay) 72 


Sector size for diskette is 128 bytes; for disk is 
256 bytes. 


Sector values for the overlay version include re- 
quired space for two different files: OVERLAY and 
DEBUG.WORK. 


Sector values for ZDBGl and ZDBG represent the op- 
tional space provided for the DEBUG.WORK file that 
is needed only if predefined command lines are to 
be stored on disk for later execution. (See SF 
command. 


4-1 AU49 


Online Debug Program Functions 


Online Debug Program performs the following functions: 


e Defines, stores, and executes (either immediately or after 
a delay, depending on the command) a sequence of commands 
from the console, or when breakpoints or trace trap in- 
structions are encountered in the program'being tested. 


e Sets, clears, or prints breakpoints in task code to monitor 
task status 


@ Displays, changes, and dumps either memory or registers; 
information may be printed on the operator's console, or 
a line printer 


e Evaluates expressions 


Debugging Command Language 


Commands are submitted to the Online Debug Program through the operator's 
console or any command terminal. A command line may consist of one or more de- 
bugging commands separated by a semicolon and terminated by a carriage return. 
Some of the commands are executed immediately, and some, by their nature, are 
executed on a delayed basis. The "predefined" or "delayed execution" commands 


are stored on disk prior to execution. 


Within commands, parameters are separated from one another by one or more 


spaces. All parameter values are entered using hexadecimal notation. 


Any command that produces printed output may direct the output to a device 
other than the operator's console by using the LRN (logical resource number) of 


the device; when no LRN is specified, the operator's console receives the output. 


Table 4-2 summarizes the debugging commands by function. The following 


pages present detailed descriptions of the commands and their use. 


Table 4-2. Summary of Debugging Commands by Function 


Command 
Function Mnemonic Meaning 


Command line Define command line n 
definition and 


handling Execute command line n 


Print all predefined command lines 


Print command line n 


Breakpoint Clear all breakpoints 
control 


Clear breakpoint n 

Proceed from breakpoint 

List all breakpoints 

List breakpoint n and associated command line 


Set breakpoint n 
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Table 4-2 (cont). Summary of Debugging Commands by Function 


Command 
Function Mnemonic Meaning 


Trace trap 
control 


Define trace command line 


Print trace command line 


Active level Set current and active level 


control 


Establish temporary level active 


Memory and 
register 
control 


Print contents of all active level registers 
Change memory 
Display memory in hexadecimal 


Display memory in hexadecimal and ASCII 


Symbol control AS Assign a hexadecimal value to symbol 

VH Print value of expression in hexadecimal 
General execution AL Activate level(s) 

Hn Print header line 

LL Line length of console in use 

RF | Reset file location 


| | SF | Specify file location | 
DEBUGGING COMMAND FORMAT AND SYMBOLOGY 


The format of debugging command lines is: 


command-mnemonicAparamAparam;command-mnemonicAparam;. . . ;CR 


The symbols in Table 4-3 are used in the command descriptions and examples 


that appear below. 
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Table 4-3. Symbols Used in Debugging Command Lines 


Arithmetic Operators 
plus sign (+) Performs addition. 
minus sign (-) Performs subtraction. 


K Multiplies a hexadecimal integer by 1024 decimal (400 in 
hexadecimal) when K is the last character of an integer 
expression. 


Address Operators 


period (.) Represents the last start address used in a previous mem- 
ory reference command (DH,CH,DP). 


ampersand (&) Represents the address of the next location beyond the 
last one used by a previous memory reference command 
(DH,CH,DP). 


brackets [ ] Signifies the contents of the location defined by the ex- 
pression within the brackets. Three levels of nesting 
may be used. 


Contents of base register n of the active level. The 
values 1 through 7 can be used for n. 


Contents of the data register n of the active level. 
The values 1 through 7 can be used for n. 


Contents of the program counter of the active level. 
Contents of the indicator register of the active level. 


Contents of the system status register (level number 
and privilege bit only) of the active level. 


SSL Represents the value of the level number of the active 
level. 


G through Z@ Twenty single-character temporary symbols having initial 
values of zero. Values may be assigned using the AS 
debugging command. 


Notational symbols 


braces {} Indicate optional parameters. 


ellipses ... Indicates the ability to repeat parameters within braces. 


parentheses ( ) Indicate command or header information to be stored for 
later use. Unmatched right parenthesis results in an 
error. A right parenthesis that is paired with the first 
left parenthesis terminates the command definition. 


Indicates a valid expression formed using expression 
elements. 


Consists of expl/exp2 where expl is a hexadecimal 

number that is a value or a location; exp2 is an option- 
al hexadecimal repeat factor whose value must be between 
1 and 32,767. If exp2 is omitted, the value of 1 is 
assumed. 


slash (/) Brings Online Debug Program to command level; also used 
to indicate reference to specific LRN for the command 
use. 


Delta (A) Indicates a space. 
CR Indicates a carriage return. 


; Separation character between commands on the same command 
line. 


Signifies "all" in the print and clear commands. 
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AL/AR/AS/C* 


Debugging Commands 


ACTIVATE LEVEL COMMAND (AL) 
Command activates a level corresponding to each expression. 
Format: 
ALAexp{AexpA. . .{ CR 


Example: 
AL A At+2 CR 


This example activates priority levels 10 and 12 (decimal) 


ALL REGISTERS COMMAND (AR) 
Command causes the printing of all registers for the active level. 
Format: 
AR{/1rn}cR 


Example: 

AR/3 CR 

This example causes the contents of all the registers for the active 
level to be printed on the device referred to as logical resource 
number 3. (See Note 6, under "Additional Operating Notes for the 
Online Debug Program", below) 


ASSIGN COMMAND (AS) 


Command assigns the hexadecimal value of the expression to the symbol; used 


to alter registers of the active level, and temporary symbols. 


Format: 
ASAsymAexp{ AsymAexp secs CR 


Example: 
AS $R1l -2 xX 1408 S$B7 xX+15 
This example causes -2 to be assigned to data register 1 and 141D 


to be assigned to base register 7, and 1408 to temporary symbol X. 
CLEAR COMMAND (C*) 

Command clears all defined breakpoints. 

Format: 


C* CR 
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Cn/CH/Dn 


CLEAR COMMAND (Cn) 
Command clears specific breakpoint. The value of n may be between 0 and 9. 
Format: 
CnACR 


Example: 
Co: :CR 


The example causes breakpoint number 3 to be cleared. 


CHANGE MEMORY COMMAND (CH) 
Command allows specific memory locations to be given specific values. 
Format: 
CHAexpArexp {Arexp...} CR 


Examples: 

CH 100 0/10 CR 

In this example, locations 100 to 10F will be zero-filled. 
CH 200 4FFF CR 


Execution of this command puts the value 4FFF into location 200. 
CH 2000 0/10 1/10 2/10 CR 


This example shows how multiple repeat factors can be used: 
execution of this command causes locations 2000 to 200F to 

be given a value of zero, locations 2010 to 201F to be given 

a value of 1, and locations 2020 to 202F to be filled with 2's. 


DEFINE COMMAND (Dn) 


Identifies the command line within the parentheses with the number n; n 


must be a value between 0 and 9. 
Format: 
DnA (command line) CR 


Examples: 
D3 (CH 100 0) CR 


This example associates the number 3 with the command within the 
parentheses. Hereafter, each time the command E3 (see below) is 
executed, the parenthetical command will be executed and location 
100 will be zero-filled. 


This next example illustrates another use of the Dn command: 
D4 ( ) 


namely, command line 4 will be deactivated. When a disk that has 
predefined command lines from a previous execution is reused, the 
lines may be referred to without redefinition. (See the Sn command.) 
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_ DH/DP/DT 


DISPLAY MEMORY COMMAND (DH) 


Command causes specified memory locations to be displayed in hexadecimal 
notation either on the operator's console, or on the device specified by the Irn 


used. 
Format: 
DH{/lrn}Arexp}Arexp...}CR 


Examples: 
DH 200 CR 


Execution of this command results in the display of the contents of 
location 200 on the operator's console. 


DH/2 200/100 CR 
Execution of this command displays the contents of locations 200 to 
2FF on the device associated with LRN 2. 
DUMP MEMORY COMMAND (DP) 


Command causes the display of (a minimum of one line) an area of memory 


starting at a specified location. Display is in hexadecimal and ASCII notations. 
Format: 
DP {/1rn}Arexp{Arexp...} CR 


Examples: 
DP 200 CR 


Execution of this command displays one line of memory in both hexa- 
decimal and ASCII, starting at location 200. 


DP/4 80/40 200/240 CR 
This command causes the contents of locations 80 to BF, and 200 to 
43F to be displayed on the device associated with LRN 4. 

DEFINE TRACE COMMAND (DT) 


Command associates the command line within the parentheses with the occur- 


rence of a trace trap or a BRK instruction not already defined as a breakpoint. 
Format: 


DTA(command line) CR 
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DT/En/GO/Hn 


Examples: 
DT (AR) CR 


This command causes all registers to be displayed each time a 
trace trap occurs. 


This next example illustrates another use of the DT command: 


DT ( ) 


namely, the deactivation of the defined trace command line. 
When a disk that has predefined command lines from a pre- 
vious execution is reused, the lines may be referred to 
without redefinition. (See the Sn command.) 


EXECUTE COMMAND (En) 


Command executes the predefined command line specified by n, a number from 
0 to 9. The En command may not be included in predefined Dn command lines; it 


is permitted in Sn and trace command lines. 
Format: 
ENACR 


Example: 
E3 CR 


GO COMMAND (GO) 

Command results in the resumption of execution on an active level after a 
breakpoint. 

Format: 


GOACR 


PRINT HEADER LINE COMMAND (Hn) 


Command causes a header line to be printed; line spacing is controlled by 
the value of n, such that when n=0, there is a skip to the head of form before 
the header line is printed; otherwise, the number of lines between 1 and 9 are 
skipped before printing. A header line may consist of any ASCII characters 
and/or expressions; expressions are preceded by a percent (%) sign. If a % sign 
is to be printed, two characters must be used (%%). A header line must end with 


a space character. 
Format: 


HnA{/lrn}A(header line) CR 
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Hn/L*/Lbe 


Example: 


HO/2 (DUMP OF BREAKPOINT FOR LEVEL %$SA) CR 

This header will be printed on LRN 2 at the top of a new page 

as soon as the carriage return is typed. The example illustrates 
a way to document dumps. The main use of the header command is 


to document printed information related to breakpoint or trace 
trap debugging. 


LIST ALL BREAKPOINTS COMMAND (L*) 


Command lists all breakpoints. 


Format: 
L*A{/1lrn}cR 
Example: 
b= -CR 
This command will cause all breakpoints to be printed on the 


operator's console. 


LINE LENGTH COMMAND (LL) 


Command specifies the line length of the console in use. The length value 


is expressed in decimal notation, and the limits are: 30< value< 126. 
Format: 
LLAvalue CR 


Example: 
LL 72 CR 


This command signifies that the console in use has a line length 
of 72 characters. 
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Ln/P* Pn/PT/RF 


LIST BREAKPOINT COMMAND (Ln) 


Command causes the listing of a particular breakpoint that was set by a Sn 


command, and lists the command line. 
Format: 
LnA{/1rn}crR 


Example: 
L2/4 CR 
This command causes the display of the command line of breakpoint 2 


on the device associated with LRN 4. 
PRINT COMMAND (P*) 
Command causes all command lines predefined by Dn commands to be printed. 


P*{/1rntCR 


PRINT COMMAND (Pn) 


Command causes specified command line predefined by Dn command to be 
printed. 


Format: 
Pn{/1rn}crR 


The value of n can be between 0 and 9. 


PRINT TRACE COMMAND (PT) 
Command causes a trace command line to be printed. 
Format: 


pT{/1rn}cr 


RESET FILE COMMAND (RF) 


Command resets the location of DEBUG.WORK, and prohibits commands that use 
this file from operation until another SF command is issued. 


Format: 
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Sn/SF 


SET BREAKPOINT COMMAND (Sn) 


Command sets a numbered breakpoint (n) at a particular location. The value 
of n can be from 0 to 9. When the breakpoint is encountered, an existing command 
line is executed, otherwise a message is displayed on the console and task ex- 
ecution ceases. The Online Debug Program now has the highest priority. The 
console message indicates the contents of the location counter and the active 


priority level. 


If there is a preexisting command line associated with a given breakpoint, 
the old command iine must be replaced with a new one, or cleared using empty 
parentheses ( ); otherwise, the old command line will be executed. (See the 


Dn command. } 


The message format is: 


BPn SP=00XXXX SSL=00XX 
Format: 

SnAexp {(command line)! CR 
Example: 


SO 100 (DH 200/10;GO) CR 


This command will cause the display of locations 200 to 20F when 
location 100 is executed. 


SPECIFY FILE COMMAND (SF) 


Command identifies the location of DEBUG.WORK file. Since the function of 
the command is to open the work file, it should be the first command executed; 
failure to do this results in the issuing of an error message as soon as a 
command which requires the work file is used. LRN is specified in hexadecimal 


notation. 
Format: 
SFALRN CR 


Example: 
SF B CR 


This example indicates the work file to be logical resource number 
ll (decimal). 
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SL/TL/VH 


SET LEVEL COMMAND (SL) 


Command sets the current and active levels to the value of exp. The current 
level remains unchanged until another SL command is issued. The default value 


for the current level is 0. 
Format: 
SLAexp CR 


Example: 
SL C CR 


This command sets the level to 12 (decimal). 


SET TEMPORARY LEVEL COMMAND (TL) 


Command sets the temporary level to the value of exp until another SL, or 


TI, command is issued, or until the end of a command line. 
Format: 
TLAexp CR 


Example: 
TL A;AR;TL B;AR CR 
This command causes all registers on levels 10 and 11 to be displayed. 


PRINT HEXADECIMAL VALUE COMMAND (VH) 
Command prints the value that is the result of the expressions used. 
Format: 
VH {/1rn}Aexp{Aexp...} CR 


Examples: 

VH[100]CR 

This command causes the display of the contents of the addres found 
at location 100. 

VH .+100-M CR 


This command causes the display of the result of the computation 
defined by the last referenced memory location plus 100 (hexa- 
decimal) minus the value assigned to the temporary symbol M. 
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Using the Online Debugging Program 


Program testing and error correction is performed as an interactive dialog 
between the operator and the Online Debug Program. To achieve control over the 
task code being tested, the Online Debug Program is given a priority higher than 
that assigned to task code, but lower than that given to the console and printer 


used by the operator for the dialog. 


The Online Debug Program is included in your application configuration by 


using the following CLM commands: 


TSA n,m (Required if breakpoints or trace traps used.) 
EVAL ZDTLRN,TLRN 

EVAL ZDDLRN,DLRN 

ADMOD filename: ZDBG 

TASK ZDTASK,1rn,level,YACT 


TLRN - The LRN of the command terminal. 


DLRN - The LRN of the disk on which DEBUG.WORK file is located. 


See Appendix A in this manual for an explanation of the other CLM command 


parameters. 


When the configuration process is finished, the Online Debug Program lets 


you know that it is ready to accept input by sending a message to the console. 


The following example contains typical operations that might be performed 


in the course of using the Online Debug Program. 


Example: 


l. Establish header, predefine a command line, initialize a 
header variable to zero. 


HO (DUMP 3M OF AREA 0) CR 
DO (HO/3;AR/3;DH/3 20/4 [8A]/1A [8B]/1A Y/i00) CR 
AS M 0 CR 
2. Set breakpoints in code under test. 
SO 300 (AS M M+1) CR 
S1 4A6 (AS M M+1) CR 
3. Activate level 8 and wait for breakpoints. 
AL 8 CR 


4. When the breakpoint occurs, execute predefined command 0 
and then continue. 


EO CR 
GO CR 
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NOTE: The predefined command line in the example above (the 
DO ...) sets up commands that will display the header, 
registers, activity indicators, and the ISA's for 
levels 10 and ll. 


ADDITIONAL OPERATING NOTES FOR THE ONLINE DEBUG PROGRAM 


1. Online Debug Program can be brought to command level either 
when the console is idle, or when the ODP is producing out- 
put, by typing the "/" character; ODP indicates that it is 
ready by printing D? at the beginning of a line. 

2. If the DP, DH, or VH commands are producing output, and an 


: (exclamation mark) is typed, the output will be aborted. 


3. Command lines for the Sn, Dn, and DT commands may not ex- 
ceed 126 characters. 


4. A GO command embedded in a breakpoint command line allows 
task execution to proceed after the desired operations 
have been performed, without further operator intervention. 


5. The following rules should be observed when using breakpoint 
instructions: 


a. Breakpoints may not be set in code that will be 
executed at the Inhibit level. 


b. Breakpoints set on the following instructions must 
be cleared (Cn command)! before continuing execution 
(GO command): any I/O, generic (BRK), scientific, 
illegal, or LEV instruction, or any instruction with 
an illegal address syllable. 


Note that the clearing of a breakpoint becomes un- 
necessary if a second breakpoint command line used on 
a nonrestricted instruction reinstates the first com- 
mand line used on a restricted instruction, when both 
are executed repeatedly within a program loop. 


6. Note that the display, change, and dump functions apply to registers 
on the active level. The active level changes depending on the op- 
eration of the Online Debug Program. The active level can be con- 
trolled in several ways: 


a. It is set to the level defined by the SL command whenever 
console input is processed thus allowing the operator to 
access registers on the same level each time a command is 
entered from the console, regardless of the change in the 
active level due to delayed commands since the last command 
entered from the console. 


b. It is set to the level at which a breakpoint or trace trap 
occurs, thus allowing the predefined command line being 
executed to display or alter registers on its own level. 


c. It may be set temporarily with the TL command so that reg- 
isters of a level different from the active or console 
levels may be displayed or altered without permanent change 
to the active or console level definitions. 


d. It is set with the SL command, and this level becomes the 
console level. 


e. Active level control is designed to assume the value that will 
most probably be needed based on the ODP action in progress; 
i.e., console, breakpoint, trace trap, or temporary reference 
to a different level. 
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LOCATING LOAD MODULES 


The CLM builds data structures, as defined by its commands, and places the 
load modules immediately following the data structures in memory. Once an appli- 
cation is fully developed, there is no requirement to know the start address of 
load modules each time the system is loaded because it is invariant and of no 


concern to the user of the application. 


During application development, however, there is a vital need to know 
where load modules are in memory. Otherwise, the link maps of load modules 
(based at zero relocation factor) are almost useless. The start address of 
each load module can be printed on the operator's console by a utility whose 
load module name is ZXMAP. This information will be of value when debugging, 
and is displayed under the following two circumstances: 


1. Load Phase of CLM reaches the normal halt indication and the 
Map option of the CLM QUIT command was used to load ZXMAP. 
The occurrence of other indicators (e.g., multiply-defined or 
undefined symbols) is incidental. If the application's load 
modules will fit into available memory on the application de- 
velopment hardware configuration, and there is an operator's 
console then ZXMAP consists entirely of initialization code. 
When loaded, (as the last load module), it uses the operator's 
console channel number known to the loader and prints on the 
console two sets of information: 


a. Names of undefined symbols 


b. Names and start addresses of all load modules 
currently memory-resident 


2. Load Phase of CLM encounters loader halt, indicating insuffi- 
cient available memory. 


This circumstance means that the data structures plus the load 
modules for the specified application will not fit into avail- 
able memory. ZXMAP may now be used to print on the console a 
list of load modules that are in memory and those that are not. 
Although ZXMAP cannot be loaded by CLM since no memory is 
available, it may be loaded as a stand-alone offline program. 
The standard bootstrap procedure for offline programs should be 
used, and the ZXMAP start address (relocation factor) should 
be specified in low memory to avoid overlaying the CLM infor- 
mation to be printed. The recommended relocation factor for 
ZXMAP is DO. 


Another possible approach is to load ZXMAP as an ADMOD .. . 
after selected ADMOD commands of the application. This will 
produce multiple maps and you can get one indicating memory 
usage before the CLM attempts to load the module that causes 
the error halt. This module will be visible in a dump of 
the loader area of memory at HMA-3 to HMA-12. 


Figure 4-1 shows a sample console output of ZXMAP. It contains 
the hexadecimal start addresses of the application load mod- 
ules. FMDEMO is the load module name of the sample user 
application. To debug FMDEMO the user needs object listings of 
the modules contained in FMDEMO (e.g., FMA, FMB, FMC) and the 
link map produced when FMDEMO was created. The link map gives 
the zero-relative offsets of tags within FMDEMO. 
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ZXEX02 *0755 
ZYFMOL *ODF9 
FMDEMO *14E0 
ZIKSR *16DF 


ZILPT *183E 
ZICDR *18AC 
ZIDSK *1922 
ZXMAP *19CA 


Figure 4-1. Sample ZXMAP Output 


Assume that FMA, FMB, and FMC were linked in that order and 
start at relative 0, 100, 200 hexadecimal, respectively. 

To locate an instruction in memory that is in module FMB, 
add 100 plus the instruction offset within FMB to 14E0) ¢- 
If a load module has not been brought into memory, 
ZXMAP prints 


<load name>*0000 
For undefined symbols, ZXMAP prints 


<symbol name>* (blank) 
DEBUGGING DURING ONLINE APPLICATION DEVELOPMENT 


Monitor Points 


The system may be monitored in several different ways to verify proper se- 
quencing of memory and/or register contents within routines, or proper task se- 
quencing. Each method requires manual insertion of monitoring code, and implies 


that space exists within the system for it. 


These are ways of creating space to insert monitor points: 
e Leave space temporarily in various application modules. 
e Append monitoring points using Program Patch. 

@ Use ODP 


The sophistication of the monitoring performed depends on the stage of the 
application development and testing. The monitoring routine could be a simple 
halt instruction, a conditional call to the Trace Trap Handler based on current 
variable status, or an Online Debug Program breakpoint. In each case, you may 
construct what is required at the time. Program Patch is described in the 


Utility Programs manual. 


If space is allocated in application modules, it may be used by invoking 


the Online Debug Program. 
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MANUAL CONTROL 


When single-word halt instructions are used as monitoring points, the use of 
the DO single instruction capability is convenient. The instruction word re- 
placed by the halt may be entered into the instruction register (D0) when the 
halt occurs, even if the full instruction occupies more than one word in memory. 


However, the halt must replace the first word of the instruction. 


For example: 


Source Line Object Code 
LAB $B2,SB4,TAG loc/ABC4 instruction word 
loc+1/0004 tag value 
ABC4 may be replaced by a halt (all zeros). When the P-register (E0) halts at 


loct+tl, the instruction register (D0) may be changed back to ABC4 and execution 
continued. Since this does not change the content of loc, the halt will reoccur 


the next time the code sequence at loc is executed. 


You can use the single word halt effectively in debug phases where only one 
priority level is active at a time. If more than one level is active, you may 
use the halt at inhibit level option of the Trace Trap Handler to "freeze" the 
entire system; i.e., all priority levels including the real time clock. This 
option is invoked by a BRK generic instruction followed by a HLT instruction. 
Now use the control panel to enter step mode to examine registers. Then execute 


a single instruction before restarting program. 


Real-Time Clock (RTC) 


Some applications require the real-time clock, activated at load time. 
While the clock is turned on, the CPU is difficult to use in single instruct 
mode because the RTC is continually generating an interrupt at clock level (level 
4). In the early stages of application debugging it may be useful to turn off 


the clock to facilitate "stepping" through a code sequence without interference. 


This is easily done using the capability of executing one instruction from 


the DO register as described in the following procedure. 


To turn off the clock before starting the application, use the capabilities 
of executing one instruction from the instruction register (whose selection code 
is DO) to execute an RTCF instruction while in single instruction mode. Then 
clear the instruction register (D0), set the P-register (E0) back to CLM halt 
address and press Ready and Execute. Once the ODP is executing: 

a. Press Stop and select DO; change to 0005. 

b. Press Execute (this turns off clock) 

c. Select DO and change to 0000. 

d. Select EO and change to CLM halt address. 


e. Press Ready and Execute. 
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Data Structures 


There are several useful hardware data structures that contain valuable in- 


formation for system debugging. 


Refer to Figure 4-2 to show portions of an actual memory dump which contains 


these structures. 


0010/ 0204 0000 0000 0000 0006 0004 0004 0000 
0018/ 0000 0000 0000 0000 0000 0000 0000 OOIE 
0020/ 0000 0000 0000 0007 0000 0000 0000 0000 


HARDWARE DEDICATED LOCATIONS 


—_—_—————_. ZEROS ————_—__-—_—— 


0078/ 0000 0000 0000 0000 0000 0000 3830 0000 
9080/ 0000 0000 0000 0253 018D O1A3 0189 OICF ISA POINTERS USED BY THIS APPLICATION 
0088/ O1E5 OFF 0211 0227 023D 0253 0269 027F 


—_——_————_ ZEROS ————_———— 


0088/ 0000 0000 0000 0000 0000 0000 0000 0187 ISA POINTER FOR LEVEL 63 
OBCO 0000 0294 3FFF 02B4 0416 OOOF 136A 3FFF CLM—SUPPLIED EXECUTIVE INFORMATION 


~<«—_| CLM DATA STRUCTURES ——_——» 


01B0/ 0000 0000 0000 1240 0500 0005 0000 FFOO 

01B8/ 0000 1000 FFFF 0000 O7AB 4000 0000 0000 

o1cO/ 1925 0000 3180 3£D0 3ED3 1903 19CF 3DA4 ISA FOR LEVEL 6 (BEGINS AT LOCATION 189 
01C8/ 3064 0000 0000 0000 0000 FFOO 0000 13C7 1 
O1D0/  FFFF 0000 O7A5 4003 183D 0205 1705 0C31 

01D8/ 17D5 02D7 1799 06018 06000 0000 0000 13C0 

O1EO/ FFFF 0007 0000 FFOO 0000 0000 FFFF 0000 

O1E8/ 07AB 4000 0000 0000 183E 0000 0000 0000 


Pu 


~+*——_ UNUSED INITIALIZED ISA’S ———-»> 


0250/ 0000 FFOO 0000 0000 FFFF 0000 0808 4003 
0258/ 0325 033F 10FD 0682 O2F5 062F 0135 0014 
0260/ FFFF 803F 0050 0000 0050 1000 0000 FFOO 
0268/ 0000 0000 FFFF 0000 O7AB 4000 0000 0000 


ISA FOR LEVEL 13 (BEGINS AT LOCATION 25316) 


—~«—_———-— REMAINDER OF ISA’S  -—-———2 


0290/ 0000 0000 0000_FFO0 [0000 0000 d000 0000 

0298/ 0000 0000 0000 0000 0000 0682 0000 0000 a PUG. TOEEE 

02A0/ 0000 0000 0000 0000 0000 0000 0000 0000 bre 

02A8/ 0000 0000 0000 0000 0000 0682 0000 0000 aaa 

02B0/ 0000 0000 0000 0000 [o2D5~02E5 02F5~ 0305 

02B8/ 0315 0000 0000 0000 0000 0000 0000 0000 =e ERT 

0200/ 0000 0204 0000 00004 02CC 0000 0000 0000 
(FOUND BY USING ZXMAP, LINK MAP, AND LISTINGS 
AND CLM-SUPPLIED INFORMATION ATCO4g ) 


Figure 4-2. Hardware/Executive Data Structures 
Location 10 contains the trap save area pointer. If traps have occurred, 


the trap save areas can be located using this pointer. Since CLM creates trap 


save areas to be contiguous, even unlinked TSA's may be located. 
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Locations 20 through 23 contain the level activity indicators. They may be 
examined to discover which level was running or waiting to run. In Figure 4-2, 


only level 63 (location 23, bit 15) was active. 


Location 80 and above contain the ISA pointers for the system. A minimum of 
64 locations are always reserved by CLM. Nonzero ISA pointers indicate the 
potentially-active levels in the system. The pointer in location 83 (level 3) 
is always either zero or a duplicate of another valid ISA pointer. By matching 
its contents against the others, you can discover the last level to execute on 


the inhibit level. In Figure 4-2, it was level 13 (location 8D). 


Within the ISA's for each level, the S-, P-, and B5-register entries are of 
interest. When the S-register contains the level number of the level itself, 
it was probably interrupted by a higher priority level. If it is zero, the level 
has probably not been executed. When the level number is 3, the task has termin- 


ated using the Task Manager. 


The P- and B5-registers may prove useful to determine the starting address 


of a task or Task Manager entry point. 


Device driver ISA's indicate whether the device interrupt has ever occurred. 
The device places information in the ISA upon interrupt. Figure 4-2 indicates a 


13C7 at location iCF. This is decoded as: 


13C0 channel number 
07 device level assignment 


The level number is the last 6 bits of the 16-bit word. 


Software data structures used by the Task Manager and/or device drivers 
may best be located by finding a reference to them in Honeywell listings, locating 
those references in the memory dump, and then examining the structures. The in- 
formation supplied by the CLM immediately after the ISA pointers may be used to 
find SOQ,EOQ, and LRT (and thereby RCT's) that may be of interest. CLM also 
provides a pointer to ZXcccc in the Clock Manager module. This is the location 
immediately before the first of four clock queue data structures. Once these 
structures are located, enqueued request blocks may be examined and clock timer 
blocks of drivers analyzed. 


Trace History 


When using the Online Debug Program with disk-stored command lines that 
execute upon encountering a trap or a breakpoint, a trace history may be main- 


tained on a line printer. Otherwise, use the Trace Trap Handler. 
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Handling Load Errors 


When the CLM produces a load error (1695) indicating insufficient memory 


for loading the application, there may be ways to rearrange load modules to 


solve the problem. 


ae 


Be certain that load modules with large load-time initial- 
ization requirements are loaded first (e.g., communications 
or File Manager) so that maximum advantage is taken of the 
possibility of overlaying CLM initialization by permanent 
load modules. Clearly, being unable to load a module because 
the initialization code is too large can be corrected by 
placing I/O drivers (DEVICE commands) or the Executive 

load modules (ADMOD commands) near the end of the load module 
commands. 


Be certain that ADMOD commands associated with floatable 
overlays are also ahead of other modules that do not have 
overlays or initialization code. Recall that floatable 
overlays need occupy no permanent memory space outside the 
CLM residue. 


Consider recoding nonfloatable overlays as floatable to make 
better use of CLM residue that can't be used during loading. 
As an extreme solution for an 8K environment, the bulk of 
the application could be coded as floatable and called into 
residue space by its root, which is designed to do nothing 
more than that. 


Double check configuration commands to make sure that the 
minimum amount of space required is used for data structures. 
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APPENDIX A 
CONFIGURATION LOAD MANAGER COMMANDS 


Commands entered through the command input stream direct the operation of 
the Configuration Load Manager (CLM). Using these commands, you can define the 
environment in which the application is to be run, and specify the modules to 
be loaded. The configuration commands identify the load module, specify the 
memory requirements, system services, and peripheral complement to be used; set 


up internal data structures, and establish trap handling procedures. 


Table A-1 summarizes the CLM commands and functions. Individual commands 


are described in detail later in the section. 


Table A-l. Summary of CLM Commands and Command Functions 


System Configuration |SYS, OIM, TSA, TRAP, Set up data structures in main 
CLOCK, DATE memory; define application en- 
vironment. 


Load Configuration ADMOD, ELOC, EVAL Constructs a load module list 
consisting of all modules re- 
quired by the application; list 
consists of file names with sub- 
lists of module names; module 
names should be unigue; the 
order of modules in the list is 
critical when they are loaded 
from a sequential device; per- 
mit symbol definition. 


DEVICE, TASK, ATLRN, Explicitly specify relationships 
EQLRN among tasks, devices, logical 
resource numbers, and interrupt 
levels; cause data structures 
to be built. 


Buffer Management® BUFSPACE Defines buffer pools and re- 
lated tables that are used by 
the Buffer Manager. 


File Management* FILMGR, DEVFILE, FMDISK,| Provide information by which 
ATFILE CLM builds the data structures 
used by File Manager to support 
a centralized file access capa- 
bility. 
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Table A-1 (cont). Summary of CLM Commands and Command Functions 


CLM Control IOS, *(comment), QUIT Direct the general actions of 
CLM; provide documentary infor- 
mation within the command input 
stream. 


Communications® COMM, TTY, VIP, BSC, Explicitly define each communi- 

MODEM, LTPDEF, LTPn, cations device; define attri- 

STATION butes of communications appli- 
cation; cause data structures 
to be built; analogous to DEVICE 
command for peripheral devices; 
specify relationships among 
tasks, devices, logical resource 
numbers, and interrupt levels. 


CLM Extensions LACT, ELACT, IOS Load the optional extensions to 
CLM so that file management, 
buffer management and communi- 
cations functions can be con- 
figured. 


“optional extensions that are added to the basic CLM through the use of the 
LACT and ELACT commands interpret the information supplied by commands in 
these groups. 


COMMAND FORMAT 


The CLM accepts commands through the designated command input device. 
Each command is a separate line of input, consisting of a string of up to 72 
ASCII characters. If the command input stream is entered through an operator 


console device, each command is terminated by a carriage return. 


A command line contains a CLM command, including its operands and 
(optionally) comments. The format of a CLM command is shown below. In this 
example, lowercase characters indicate items that are to be replaced by actual 
values. Operands shown within brackets are optional; default values are used 
if these operands are not specified. 

NOTE: The command mnemonic itself need not be specified if all 


the operands of the command are optional and if the de- 
fault values of those operands are to be used. 


Position Position 
1 72 


mnemonicAoperandl [,...,operandn] [Acomments] 


The command mnemonic, consisting of one or more ASCII characters, specifies 
the action to be performed. The command mnemonic is separated from its operands 
by a single space character (indicated by a delta (A) character). Commas 


separate individual operands and a space or carriage return terminates the 
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operand set. Omitted operands are indicated by consecutive commas; trailing 
commas are not required. Comments can follow the operand field, separated from 
the operands by one or more space characters. The order of operands in the 


command line is significant. 


The operands associated with the CLM commands can be strings of ASCII 
characters, or decimal or hexadecimal integers. An ASCII Operand begins with 
an alphabetic character or with an apostrophe character and ends with a comma, 
space, carriage return, or apostrophe character or when the maximum string 
length of 64 characters is reached. For purposes of specifying a numeric 
string, as opposed to a decimal number, the string must be bracketed by 
apostrophes. ASCII strings are stored in memory in an even number of bytes, 
left-justified on a word boundary. 


An integer used as a command operand is unsigned and can be a single-word 
decimal or hexadecimal number or a double-word hexadecimal number. The follow- 


ing conventions are used to represent integers in an operand string: 


ddddd - Single-word decimal; d is a digit in the range 0 


X'hhhh' -—- Single-word hexadecimal; h is a digit in the range 
0 through F 


D'hhhhhhhh' - Double-word hexadecimal; h is a digit in the range 
0 through F 


In memory, an integer is right-justified on a word boundary, and left- 
filled with zeros. An operand that specifies an address must be a double- 
word hexadecimal integer. . 

NOTE: In the following description of CLM commands, the term 


"integer" refers to a single-word integer unless other- 
wise noted. 


INPUT DEVICES FOR CLM 


Command input to CLM can be submitted on cards, on diskette, or through 
an operator's console (a KSR device). During the execution of CLM, the command 


input device can be changed by the IOS command. (See "IOS Command" later in 
this appendix.) 


Under the direction of these commands, CLM accepts load modules on diskette 
files, loads these modules into memory, and initiates the execution of the 
application. 


The diskette file and member names of the command input to CLM must be 
CLMCI when the Command Processor is not in use. 


A-3 AU49 


ADMOD/ATFILE 


ADMOD Command (Add Load Module) 


The ADMOD command adds a new module name to the end of the load module 
list, and specifies that this module is to be loaded during the loading phase. 
The order of ADMOD commands determines the order in which the load modules are 
loaded. 


NOTE: The fact that new module names are added to the end of 


the load module list can be significant when loading is 
to be done from a sequential device, since only one pass 
is made over the medium. 


The format of the ADMOD command is shown below. 
ADMODAfile-name:member-name[,X'channel'] 


ADMOD - Command mnemonic 
file-name - The name of the file in which the load module resides. 


member-name - The name of the load module. This load module is a 
member of the file whose name is specified in the file-name 
element. 


channel - A hexadecimal integer giving the channel number of the 
device from which the specified file/module is to be loaded. 
If this operand is omitted, the channel number of the device 
from which the Configuration Load Manager was loaded is used. 


The ADMOD command with the same file-name/member-name as a previous ADMOD 
command causes the channel number to be updated with the new one. This is 
useful if a driver module must be loaded from a different channel than the 
default channel specified in the implicit ADMOD statement that is issued with 
the following commands: DEVICE, COMM, TTY, VIP and BSC. 


The explicit ADMOD command to alter parameters present in an implicitly 
invoked ADMOD command is issued after the command that caused the implicit 


command to be issued. 


ATFILE Command (Attach File) 


The ATFILE command relates a logical file number to a file. The format 


of the command is shown below. 
ATFILEA1f£n, path-name 


ATFILE - Command mnemonic. 


lfn - The logical file number used to refer to the file once 
that file has been opened. This value must not exceed 
the max-lfn specified in the FILMGR command. 
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ATFILE/ATLRN 


path-name - A string of ASCII characters specifying the directory 
path required to reach the indicated file. The path for 
diskette begins in the directory of mounted volumes. 
The path-name has the form: system or user ( ) iden- 
tifier volume-name>file-name. The greater than symbol 
(>) must be used to separate the volume-name from the 
file-name. A volume-name may be up to six characters 
in length; a file-name may be up to 12 characters long. 


A nondiskette path-name has the same form as a diskette file-name; i.e., 
1 to 12 characters without the greater than (>) sign preceding it. Refer to 
the Executive and Input/Output manual, "Glossary of File Manager Terms" for 


more detail. 


ATLRN Command (Attach LRN) 

The ATLRN Command relates a logical resource number (LRN) to a physical 
priority levei. The ATLRN command assumes that all levels within the specified 
range that are not explicitly defined in DEVICE commands are available for use 


by nondevice tasks. 


LRN's not explicitly assigned a level by a DEVICE, TASK, or ATLRN command, 
remain unassigned. Attempts to use an unassigned LRN result in a "request 


task" error. 


The ATLRN command can also be used to relate additional LRN's to a given 


level number. 


The format of the ATLRN command is shown below. 


ATLRNAIrn, level [,rct-size] 


ATLRN Command mnemonic. 


lrn - The logical resource number, no greater than the value of 
the hilrn operand of the SYS command. 


level - The priority level at which the task requested by the 
specified logical resource number will execute. The 
value of the level operand cannot be less than 5 nor 
greater than the value specified as the lolevel of the 
SYS command. 


rct-size - An integer that gives the size, in words, of the RCT for 
the associated LRN. The default value is one word. If 
the rct-size parameter is omitted, the default value will 
be assumed, unless the level parameter is the same as 
that in a previous DEVICE, TASK, TTY, VIP, BSC, LTP, 
STATION, or ATLRN command; in this case, no new RCT is 
created, the lrn becomes a synonym for the 1lrn in the 
previous command having the same level parameter value. 
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The following rules apply to an ATLRN command: 


e An ATLRN command with an rcet-size parameter always produces an 
RCT of that size; its LRN is never a synonym. 


e The Irn of an ATLRN command that has no rect-size parameter is 
synonymous with the lrn of the immediately previous TASK, DEVICE, 
TTY, VIP, BSC, LTP, STATION, or ATLRN command having the same 
level parameter value. 


e The default value of the rct-size parameter is one word. 


The use Of the ATLRN command allows you to relate RCT's of different 

Sizes to the same priority level. Consider the following set of commands: 

DEVICE CDR,1,6,X'0580' 

ATLRN 2,6 

ATLRN 3,6,19 

ATLRN 4,6,37 

ATLRN 5,6 
The RCT constructed as a result of a DEVICE command is 16 words long; LRN 2 
is a synonym for LRN 1 and refers to the same RCT. LRN's 3 and 4 are unique, 
and refer to RCT's of 19 and 37 words, respectively. LRN 5 is a synonym for 
LRN 4, and refers to the same RCT. Priority level 6 then, has three RCT's 


associated with it: one of 16, one of 19, and one of 37 words. 


BSC 
BSC 2780 Command 


This command identifies each binary synchronous communications line in- 
cluded in the system. The format of the BSC command is: 


BSCAlrn, level,channel[,label] [,modem] [, primary/secondary] [,character-set] 


BSC - Command mnemonic. 


ilrn - The logical resource number by which the device is requested. 
It must be less than or equal to the hilrn parameter of the 
SYS command. 


level - The priority level at which the driver for the device will 
execute. Must be less than or equal to the lolevel parameter 
of the SYS command; it may be the same as other communications 
devices, but must be different from the level specified in the 
COMM command, and from the levels for noncommunications tasks 
and devices. 


channel - The channel number of the device. 


label - A label, assumed to be a location definition, which must be 
defined in a load module. This label is the entry point of 
the attention subroutine. The default is null. 


modem - A number specifying the type of data set. Possible values 
are: 


0 - Direct connect. 


1 - Bell 1xx-type modem (103A,113F,etc). Both data-set-ready 
and carrier-detect signals are needed for a connection; 
lack of both signals is a disconnection. 
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2 - Bell 2xx-type modem (201A,201C,208A,etc). The data-set- 
ready signal is needed for a connection; lack of this 
signal is disconnection. 


3 or greater - User-defined modem type (see MODEM command). 
The default value is modem type 2. 


primary/secondary - Values may be specified as P or S; indicates 
whether this is the primary or secondary endpoint of the 
transmission. A primary endpoint has higher priority when 
sending data. 


character set —- One of the following may be specified: 
AS - ASCII (default) 
EB - EBCDIC 
TE - Transparent EBCDIC 


When this command is processed, an implicit ADMOD command is issued to 


include the BSC line-type processor (ZQPBSC) in the load list. 


BUFSPACE 


BUFSPACE Command (Pool Definitions) 


The BUFSPACE command defines contiguous areas of memory (called "blocks") 
to be used as buffer areas. Blocks of uniform size are linked into a pool. 
Each pool is controlled by a pool parameter block (PPB), which describes the 
location of the first block in the pool and the size of blocks in this pool. 

A set of PPB's, in order by block size, forms a pool parameter table (PPT). 
The information contained in the PPT is required if the Buffer Manager function 
of the Executive is used. The BUFSPACE command can be used to: 

e Assign a label to the start of the PPT 


e Specify the size of each block and the number of blocks in each 
pool 


e (Optionally) Designate a predefined label in an existing load 
module as the start of the memory area containing the buffer 
pools. Alternatively, buffers are created in the residual mem- 
ory area between the end of the last load module and the high 
memory address specified in the SYS command. 


The BUFSPACE command defines one PPT and its associated buffer pools. The 
CLM arbitrarily creates the PPT in nondedicated memory and defines the value 


of the ppt-label parameter as the start of the PPT, 


The format of the BUFSPACE command is shown below. 


BUFSPACEAppt-label, [space-name] ,size,number[,size,number,...] 
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ppt-label - The label assigned to the first word of the pool parameter 
table. 


space-name - The label of the beginning of a contiguous area in main 
memory, large enough to contain all the pools defined by the 
succeeding operands in this command. If this operand is omitted, 
the buffers will be built in residual main memory space, between 
the end of the last load module and the high memory address. 


size,number - A pair of integers specifying the size (in words) of 
each block and the number of blocks in one buffer pool. As many 
size, number operand pairs as are needed can be specified. 


If the entire BUFSPACE command cannot be included on one line, additional 
BUFSPACE commands may be issued having the same ppt-label, a null space-name 


operand, and additional size, number operand pairs. 


An operand pair with the same size parameter as a previous one (the same 


ppt-label), causes the new number to replace the old one. 


The same space-name in an additional BUFSPACE command as in a previous 


one results in an error condition. 


A BUFSPACE command with a nonnull space-name, and a ppt-label the same as 


a previous one, replaces the old space-name with the new one. 


CLOCK 


CLOCK Command (System Clock) 


The CLOCK command specifies the line frequency used to drive the system 
clock, and the period between clock-generated interrupts (i.e., the timeout 


interval). The format of the CLOCK command is: 
CLOCKA [hz], [scan-cycle] 


CLOCK -~ Command mnemonic. 


hz - Line frequency. Possible values are 50 to 60. 
The default value is 60 (U.S. standard). 


scan-cycle - The time, in milliseconds, between periodic real- 
time clock-generated interrupts. The default 
value is 50 milliseconds. The following lists show 
the possible values of the scan-cycle for both line 


frequencies: 
50-Hz line 60-Hz line 
(milliseconds) (milliseconds) 
10 8 
20 16 
50 25 
100 33 
50 
100 
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COMM 


COMM (Communications System Command) 


This command specifies the interrupt priority level for all communications 
devices. This level should be higher than all other devices and tasks, the 


recommended level is 5. The format of the command is: 
COMMAlevel 


COMM - Command mnemonic. 


level - The priority level used as an interrupt level for all 
communications devices. Must be greater than or equal 
to 5, and less than or equal to the lolevel parameter 
of the SYS command, and must be unique. The COMM com- 
mand must precede all other CLM communications commands. 


When this command is processed, two implicit ADMOD commands are issued: 
one for the Communications Supervisor, and one for the MLCP Driver. The de- 
fault channel number (from which the CLM was loaded) is assumed. If necessary, 
explicit ADMOD commands, issued after the command that caused the implicit 
command to be issued, can be used to change the channel number. The implicit 
commands are: 


ADMOD CLMCOMM:ZQEXEC (For the Communications Supervisor) 
ADMOD CLMCOMM:ZQMLON (For the MLCP Driver) 


DATE 


DATE Command (Date and Time) 
The DATE command specifies the current date and time. The format is: 


DATEA['yymmdd'][,'time'] 


DATE - Command mnemonic. 


yymmdd - An ASCII numeric string providing the current year, month, 
and date. If this operand is omitted, the default value 
is null. 


time - An ASCII numeric string providing the time of day, in the 
format hhmm, where hh is the hour of the day (an integer 
in the range 00 to 23), and mm is the minute of the hour 
(an integer in the range 00 to 59). If this operand is 
omitted, the default value is null. 
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DEVFILE 


DEVFILE Command (File Management Devices) 


The DEVFILE command identifies the nondisk devices that can be used by the 
File Manager. For any given device, the DEVFILE command must be issued after 
the corresponding DEVICE, TTY, VIP, or BSC command that defines its device 
type and logical resource number. The format of the DEVFILE command is shown 


below. 
DEVFILEAdevice-name, 1lrn, file-name[,double] [,share] [,rec-size] 


DEVFILE - Command mnemonic. 


device-name - A string of ASCII characters identifying the device. 
Possible values for the DEVFILE (column 2, below) are: 


DEVFILE DEVICE 
Device Type Command Command 
KSR - input and output KSR KSR 
KSR - input only KSI KSR 
KSR - output only KSO KSR 
ASR - keyboard input/output ASR ASR 
ASR - keyboard input only ASI ASR 
ASR - keyboard output only ASO ASR 
ASR - paper tape reader TTR ASR 
ASR - paper tape punch TTP ASR 
Line printer LPT LPT 
Serial printer SPT SPT 
Card reader CDR CDR 
Diskette (See FMDISK) DSK 
Cartridge disk (removable) (see FMDISK) RCD 
Cartridge disk (fixed) (See FMDISK) FCD 
TTY - input and output TTY 
TTY - input only TTYI (See TTY command) 
TTY - output only TTYO 
VIP - input and output VIP 
VIP -— input only VIPI (see VIP command) 
VIP - output only VIPO 
BSC - input and output BSC (see BSC command) 


Note that the corresponding device-name (column 3, above) must have 
appeared in a previous DEVICE, TTY, VIP or BSC command. 


lrn - Logical resource number by which the device is requested. The 
value of this operand must not exceed the value of the hilrn 
Operand specified in the SYS command. The operand must have 
appeared in a previous DEVICE, TTY, VIP or BSC command. 


file-name - A string of up to 12 ASCII characters specifying the 
name by which the file (device) is identified within the appli- 
cation. 


double - If the ASCII character D is specified for this operand, all 
reads and writes to this file will be double buffered. If the 
Operand is omitted, file reads and writes are not double buffered. 
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Share - If the ASCII character S is specified for this operand, the 
device can be shared. If the operand is omitted, the device 
cannot be shared. 


rec-size - The maximum record size in bytes for the device file 
described in this command. The default (decimal) values for 
individual devices are: 


KSR/ASR/TTY %2 
ASR (read or punch) 32,767 
VIP (input and output) 32,767 
VIP (input or output only) 80 
BSC (input and output) 32,167 
Line printer 137 
Serial printer 133 
Card reader 80 


NOTES: 1. The "double" and "share" parameters are mutually 
exclusive, you cannot use double buffering with 
a shared file. 


2. A file cannot be bidirectional and double buffered. 


3. Double buffering should be used in conjunction with 
the following device-name parameters: KSI, KSO, 


--sT 


TTYI, TTYO, VIPI and VIPO. 


DEVICE 


DEVICE Command (I/O Device Task) 


Bach device to be used in the application must be explicitly defined in 
a DEVICE command. In addition, the DEVICE command implicitly defines the load 
module for the driver. The device-type operand is a generic name - there may 
be more than one device of the same type in the application; e.g., two diskettes. 
The level and channel operands, however, must be unique for each device. De- 
vice levels usually occupy a higher priority than task levels. The Irn 
operand specifies the logical resource number for the device. The lrn by which 
a device is requested need not be unique, but if a device is requested by more 
than one Irn, the ATLRN command must be used to relate these additional l1rn's 


to the single level for that device. 


Specifying the same device-type and lrn operand values in more than one 
DEVICE command causes the previous DEVICE command to be updated with the new 
level and channel operand values. 


The format of the DEVICE command is shown below. 


DEVICEAdevice-type,1lrn,level,channel[,label] 
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DEVICE - Command mnemonic. 


device-type - A string of ASCII characters identifying the type of 
device. Possible values and associated devices are shown be- 
low. 


Device Type Operand Value Driver Name 
KSR KSR ZIKSR 
ASR ASR ZIASR 
Line Printer LPT ZILPT 
Serial Printer SPT ZILPT 
Card Reader CDR ZICDR 
Diskette DSK ZIDSK 
Cartridge disk FCD (fixed) ZICDSK 
Cartridge disk RCD (removable) ZICDSK 


lrn -The logical resource number by which the device is requested. 
The value of this operand must be an integer that is less than 
Or equal to the hilrn value specified in the SYS command. 


level ~ The priority level at which the driver task for the device 
will execute. The value of the level operand cannot be less 
than 5 nor greater than the value specified as the lolevel para- 
meter of the SYS command. 


channel - The channel number of the device. 


label - The label parameter may be either an ASCII value (location 
definition), or an integer (reference LRN) that is the lrn 
parameter of a previous DEVICE command. When the label para- 
meter is given an ASCII value, the value must be defined ina 
load module. The address of the label is stored as the first 
entry of the device-specific words in the device resource con- 
trol table (see the Executive and Input/Output manual). This 
parameter can be used by the drivers as needed, except that 
when it appears in a DEVICE command describing a KSR or an ASR, 
it must be the entry point of the attention subroutine. The 
default label for LRN 0 (operator's console) is ZIATTN, which 
is defined in the Executive load module. The default for other 
LRN's is null. 


When the label parameter is used as a reference LRN (i.e., the 
value is identical to the LRN value of a previous DEVICE 

command), the location of the RCT for the previously defined 
device is stored as the first entry of the device-specific 

words in the RCT for the currently defined device. Conversely, 
the location of the RCT for the currently defined device is stored 
in the corresponding position in the RCT of the previously defined 
device. DEVICE commands specifying removable and fixed cartridge 
disk devices must cross-reference each other in this manner. 


The following pair of DEVICE commands illustrates a valid use 
of the label parameter as a reference LRN: 


DEVICE FCD,6,10,X'1280' 
DEVICE RCD,9,10,X'1280',6 
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The following rules apply to the use of the label parameter as a reference 
LRN: 


e The first DEVICE command of a related pair may not have a reference 
LRN to another DEVICE command; result iS an error. 


e The level and channel parameters of a DEVICE command that has a 
reference LRN must be the same as those in the related DEVICE com- 
mand. 


9 Given a related pair of DEVICE commands, the reference LRN must 
be the same as the LRN in the related DEVICE command. 


An implicit ADMOD command for the driver load module of the form: 
ADMOD CLMFILE:<driver-name> 


is issued with each DEVICE command. The default channel number is assumed. If 
the default channel number cannot be used, an explicit ADMOD command having the 
file-name:module-name but a new channel number can be used to change the 


channel number. (See the ADMOD command.) 


An implicit TASK command of the form: 


TASK start-address(of the device) ,1lrn,level 


is also issued with each DEVICE command. 


ELACT 


ELACT Command (End Load Action) 


The ELACT command indicates that all interpretive modules have been in- 
cluded, and that all commands submitted to the CLM can be processed. The 


format of the ELACT command is: 


ELACT 


ELACT - Command mnemonic. 


NOTE: Prior to the processing of the ELACT command, only the IOS, 
LACT, and ELACT will be recognized as valid commands, the 
submission of any other command will result in an error 
condition. Once this command is processed, all other com- 
mands will be accepted, and the IOS, LACT, and ELACT commands 
will be invalid. 


The ELACT command must be issued even if no optional modules are to be 
added to CLM. 
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ELOC/EQLRN/EVAL 


ELOC Command (Define Address Symbol) 


The ELOC command defines a symbolic name as an absolute address. The 


definition is stored in the symbol table, and redefinition is not allowed. 


The symbolic name may be referred to in the loading process. 
the ELOC command is shown below. 


The format of 


ELOCAsymbol,D'absolute-address' 


ELOC - Command mnemonic. 


symbol - One through six ASCII characters specifying the symbolic 
name to be assigned. 


absolute-address - The double-word hexadecimal integer specifying 
the absolute address that is the definition of the symbol. 


EQLRN Command (Equate LRN's) 


The EQLRN command provides for the definition of LRN synonyms. The format 


is: 
EQLRNAnew-1lrn,old-lrn 
EQLRN - Command mnemonic. 


new-lrn - A integer, no greater than the value of the hilrn parameter 
of the SYS command, that is to be equated to a previous LRN. 


old-lrn - The value of a previously assigned LRN for which a synonym 
is being provided. 
EVAL Command (Define Value Symbol) 


The EVAL command defines a symbolic name as a value. 
stored in the symbol table, 


The definition is 
and redefinition is not allowed. 
may be referred to during the loading process. 
is shown below. 


The symbolic name 
The format of the EVAL command 


EVALAsymbol,value 
EVAL - Command mnemonic. 


symbol - One through six ASCII characters specifying the symbolic 
name being defined. 


value - A single-word integer whose value becomes the definition 
of the symbol. 
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FILMGR/FMDISK/IOS 


FILMGR Command (File Manager) 


The FILMGR command defines the general File Manager variables. This 
command must precede any other file management commands. The format of the 


FILMGR command is shown below. 


FILMGRA [max-lfn] [,concurrentcalls] [,concurrent opens] 


FILMGR - Command mnemonic. 


max-lfn - A value <255 representing the highest logical file number 
(LFN) permitted in the application. The LFN is the value used 
to refer to a file once that file has been opened. The default 
value of this operand is 15. 


concurrent calls - The number of concurrent calls to the File Manager. 
This number must be an integer greater than zero. The default 
value is 4. 


NOTE: Each task can have only one call to the File Manager at 
a time, but a number of tasks can have one call each at 
a given point in time. 


concurrent opens - The number of concurrently open files. This number 
must be an integer greater than zero. The default value is 8. 


FMDISK Command (File Management Disk) 


The FMDISK command identifies the disk devices available to the File 


Manager. The format of the FMDISK command is shown below. 
FMDISKAdisk-type,1rn 


FMDISK - Command mnemonic. 
disk-type - Specifies the disk device. 


DSK - Diskette 
RCD - Removable cartridge disk 
FCD - Fixed cartridge disk 


lrn - The logical resource number by which the device is re- 
quested. The value of this operand must not exceed the 
value of the hilrn operand specified in the SYS command. 


IOS Command (I/O Stream) 


Using the IOS command, you can change the command input stream from one 


device to another. The format of the IOS command is shown below. 


IOSACIS,device,X'channel' [,member-name] 
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IoS - Command mnemonic. 
CIS - The name of the command input stream. 


device - A string of ASCII characters designating the new command 
input device. Possible values are: device mnemonics (SCDR or 
SKSR) or a disk file-name. 


channel - A hexadecimal integer specifying the channel number of the 
new command input device. 


member-name —- The member name of the command input list on a disk 
device. The file in which this member resides is the file-name 
parameter. If the parameter is omitted, CLMCI is assumed. 


LACT 


LACT Command (Load Action) 


The LACT command identifies a load module to be added to CLM in order to 
provide interpretation of one of the supplementary command groups. One LACT 
command must be included for each set of command group extentions required in 


the configuration. The format of the LACT command is: 


LACTA£ile-name:module-name[,X'channel'][,waid] [,overlay] 


LACT - Command mnemonic. 


file-name - The name of the file in which the interpretive modules 
for the particular command group reside. 


member-name - The member name of the load module that provides the 
interpretive routines for the particular command group. 


channel - The channel number (hexadecimal) of the device from which 
the load module is to be loaded. The défault value is the 
channel from which the CLM was loaded. 


waid - The identification number of the work area for this module. 
If this number is omitted, the work area is not to be shared; 
if the number is the same as that supplied in the LACT command 
for another interpretive module, the work area can be shared. 


overlay - The letter O indicates that the interpretive modules spe- 
cified in this command are to be treated as overlays during the 
execution of CLM; if the parameter is omitted, all modules are 
resident in main memory during CLM operation. The parameter 
must be coded when HMA is 1FFF (8K). 


LTP 


LTPDEF (Command (LTP Definition) 


This command specifies the size of the communications tables that the 
user-written LTP requires. The command is optional, but if used, must pre- 


cede the LTPn command that refers to it. The format is: 
LTPDEFAn,channel-table-size,station-table-size 


LTPDEF - Command mnemonic. 


n —- Specifies which LTP is being defined; n is a number from 0 to 3. 
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channel-table-size - Specifies the number of words needed for the 
channel table and the COB's. The default value is 32 words. 


station-table-size - Specifies the number of words needed for this 
LTP's station table (RCT). The default value is 7 words. 


LTPn 


LTPn Command 


This command specifies the characteristics Of a nonstandard communi- 
cations device. For each device driven by a user-written LTP, this command 


must be issued. The format of the command is: 


LTPAlrn,level,channel [,label] [,modem] [,speed] [,FDX/HDR] [, LTP-specific-word] 


LTPn - Command mnemonic. There may be up to four user-written LTP's 
included in a configuration. The mnemonics could be: LTPO, 
LTP1, LTP2, or LTP3, depending on which user-written LTP is 
being defined. CLM saves the number in the channel table for 
the device for use by the LTP's initialization code. 


lrn - Specifies the logical resource number by which the device is 
requested; must be less than or equal to the hilrn parameter 
of the SYS command. 


level - The priority level at which the driver for the device will 
execute. Must be less than or equal to the lolevel parameter 
of the SYS command; it may be the same as other communications 
devices; but must be different from the level parameter in the 
COMM command, and from the levels specified for noncommunica- 
tions tasks and devices. 


channel - The channel number of the device. 


label - A label, assumed to be a location definition, which must be 
defined in a load module. This label is the entry point of the 
attention subroutine. The default label for LRN 0 (operator's 
console) is ZIATTN, which is defined in the executive load module. 
The default for other LRN's is null. 


modem - A number specifying the type of data set. Possible values 
are: 
0 - direct connect 


1 - Bell lxx-type modem (103A,113F, etc.) Both data-set-ready 
and carrier-detect signals are needed for a connection; 
lack of both signals is a disconnection. 


2 - Bell 2xx-type modem (201A,201C,208A, etc.) The data-set- 
ready signal is needed for a connection; lack of this signal 
is a disconnection. 


3 or greater - User-defined modem type. (See MODEM command.) 
The default value is modem type 2. 
NOTE: If the line is direct connect and asynchronous, modem 


type 2 must be specified; if the line is direct connect 
and synchronous, specify modem type 0. 


speed - The data rate in bits per second. The default value is zero, 
and signifies a synchronous line. One of the following values 
must be specified for an asynchronous line: 


50 300 2400 
75 600 3600 
110 900 4800 


134.5 1200 7200 
150 1800 9600 
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FDX/HDX - Specifies whether the procedure is full or half duplex. 
If it is full duplex (FDX), two channel tables will be assigned. 
The default value is HDX. 


LTP-specific-word - A word containing user-defined information to 
be passed to the LTP via the station table at offset ZQSSTS. 
The default is zero. 


NOTES: 1. An LTPDEF command must precede its corresponding LTPn 
command unless default values are to be taken for the 
channel and station table sizes. 


2. Each LTP load module must be added to the load module 
list constructed by CLM in the usual way; i.e., by 
being identified in an ADMOD command. 


MODEM 


MODEM Definition Command 


This command is used to define an nonstandard modem type. (See the MLCP 
Programmer's Reference manual for details about contents of the line control 
tables.) The information provided in this command is used to test entries in 
the LCT for the device to verify a connection or a disconnection. The format 
of the MODEM command is: 


MODEMAtype-number,connection-AND-mask,connection-XOR-mask, 
disconnection-AND-mask ,disconnection-XOR-mask,data-set- 
control 


MODEM - Command mnemonic 


type-number - An integer from 3 to 15 that is assigned to this modem 
definition and may then be used in a communications device com- 
mand. 


connection-AND-mask - A 2-digit hexadecimal number whose value deter- 
mines which bits of LCT entries 14 (receive channel data set 
status) and 46 (transmit channel data set status) will be examined 
when a connect request is processed. 


connection-XOR-mask ~ A 2-digit hexadecimal number whose value spe- 
cifies which bits of LCT entries 14 and 46 must be on for a 
connection 


disconnection-AND-mask ~- A 2-digit hexadecimal number whose value de- 
termines which bits of LCT entries 14 and 46 will be examined 
when a disconnect request is processed, or when a test for the 
occurrence of a disconnect is made. 


disconnection-XOR-mask ~- A 2-digit hexadecimal number whose value de- 
termines which bits of LCT entires 14 and 46 must be on for a 
disconnection. (Entries 14 and 46 of the LCT are the data set 
status for the receive and transmit channels, respectively.) 


data-set-control ~ A 2-digit hexadecimal number placed in entry 
number 20 of the LCT and line register 2 (LR2) of the communi- 
cation line adapter (CLA) when a line is to be connected. 


NOTES: 1. To test for a successful connection, entries 14 and 46 
of the LCT are first subjected to a logical AND opera~ 
tion against the (user-supplied) connection-AND~-mask; 
then a logical exclusive OR operation is performed on 
the result of the first operation, against the (user- 
supplied) connection-XOR-mask. If the result is zero, 
a connection has been established. 


A-18 AU49 


2. To test for a disconnection, the same operations are 
. ee . e 
carried out using the analogous disconnection masks. 
A zero result indicates a disconnection. 


3. The following table shows the mask and data set control 
values for the standard, CLM-recognized modem types: 


Modem Type Connection Masks Disconnection Masks Data Set 
Type Number AND XOR AND XOR Control 
Direct 0 Xx'80' xX'80' ee x'OO' X'88' 
Connect 
Bell 1xx 1 X'AO' X'AO' X'AO' x"00" x'80' 
Bell 2xx 2 X'80' x'8Oo' baie 36 ay x'00' X'80' 


OIM 


OIM Command (Operator Interface Manager Definition) 


The OIM command defines the lrn and level required by the Operator Inter- 
face Manager. This command must be present, or an initialization error will 


occur during the loading of the Executive load module. The format of the OIM 


command is: 


OIMAIlrn,level 


OIM - Command mnemonic. 


lrn - The logical resource number reserved for use by the Operator 
Interface Manager. The vaiue is an integer that is less than 
or equal to the value of the hilrn parameter in the SYS com- 
mand. 


level - The priority level at which the Operator Interface Manager 
operates. The value cannot be less than 5 nor greater than 
the lolevel parameter of the SYS command. 


QUIT 


QUIT Command (Initiate Loading) 


The QUIT command is the last configuration command in the command input 
stream. When this command is encountered, the CLM stops reading commands from 
the command input file and initiates the loading phase. As a last step in the 
configuration phase, the CLM creates a set of nondedicated data structures 
(tables, save areas, pointers, etc.), based upon the information contained in 


the previous commands. 


If the HLT parameter is present in the QUIT command, the processor will 
halt after the configuration loading is completed and before the application 


is started. The format of the QUIT command is shown below. 


QUITA [HLT] [MAP] 
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QUIT -—- Command mnemonic. 


HLT - Specification of this parameter causes the machine to halt 
after loading and before beginning the execution of the 
application. The default assumption is not to halt. Do 
not execute a control panel master clear operation before 
application execution. 


MAP - Specifying this parameter causes ZXMAP to be loaded last 
(provided an operator console is present) automatically. 
ZXMAP must be on the same file as CLM. 


This parameter is equivalent to an implicit ADMOD command: 


ADMOD PROGFILE: ZXMAP 


STATION 


STATION Command 


This command is used to specify additional devices on lines controlled by 
LTP's that have been written to handle multiple devices per line. One device 
on the line must be identified by describing it in an LTPn command; additional 
devices are specified in STATION commands, one per device, immediately follow- 


ing their corresponding LTPn commands. The format of the command is: 
STATIONAI1rn[,label] [, LTP-specific-word] 


STATION - Command mnemonic. 


lrn - Specifies the logical resource number by which the device is 
requested; must be less than or equal to the hilrn parameter of 
the SYS command. 


label - A label, assumed to be a location definition, which must be 
defined in a load module. This label is the entry point to the 
attention subroutine. The default label for LRN 0 (operator's 
console) is ZIATTN, which is defined in the executive load 
module. The default for other LRN's is null. 


LTP-specific-word - A word containing user-defined information to be 
passed to the LTP via the station table at offset ZQSSTS. 


NOTE: The priority level, channel number, modem type, line speed, 
and line procedure (FDX/HDX) of devices described in STATION 
commands, are obtained from the preceding LTPn command. 


Svs 
SYS Command (System) 


The SYS command defines the environment in which the online application 
will be run. When specified, the SYS command must be the first CLM command 
entered (with the exception of the IOS or DATE command). The format of the 
SYS command is: 


SYSA[,hilrn] [,lolevel] [,SAF] [,D'himem'] 


SYS - Command mnemonic. 


hilrn - The highest logical resource number (LRN) to be used by 
the application. The specification of this operand de- 
termines the size of the logical resource table (LRT) 
for the application. (The size of the LRT equals hilrn+tl.) 
The default value of hilrn is 15. The maximum value is 255. 
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lolevel - The lowest priority levei to be used by the application. 
This parameter also establishes the number of interrupt 
save areas (ISA's) and affects the total area set aside 
for ISA's and for the start-of-queue and end-of-queue 
header tables. The value of the lolevel operand must be 
between 6 and 62 inclusive. The default value is 15. 


SAF - Model designator. The default value is SAF. 


D'himem' - The double-word hexadecimal integer specifying a main 
memory address. The himem operand permits a main memory 
area between the end of the system and the physical end 
of memory to be used for nonsystem use (e.g., for storing 
an offline dump routine). The default value of the himem 
operand is the high-memory address of the loader. It is 
the end of the main memory area for buffers. 


TASK 
TASK Command (Define Task) 


The TASK command defines an initial start address for a level. It is 
used for a task that requires exclusive use of a level (i.e., is requested by 
means Of an implicit-start-address request block) or by an initially active 


application task. The format of the TASK command is: 
TASK start-address,1lrn,level[,activity] 


TASK - Command mnemonic. 


start-address - An ASCII label that is the start address of the first 
task code to execute on a particular level after the system is 
started. The label is declared in an XDEF statement in an assem- 
bly language program, and an EDEF statement to the Linker. 


lrn - The logical resource number by which the task is requested. 
The value of this operand must be an integer no greater than the 
hilrn value specified in the SYS command. 


level - The priority level at which the task will execute. The value 
of the level operand cannot be less than 5 or greater than the 
value specified as the lolevel of the SYS command. 


activity - The value of this operand determines the setting of the 
level activity indicator. Possible values and their interpreta- 
tions are: 


YACT - The task is initially active. 
NACT - The task is not initially active. 


The default value is NACT. It is the task on the highest pri- 
Ority level that has been declared active (by a YACT in its 
TASK command) that is entered when execution starts. 


TRAP 


TRAP Command (Trap Vector) 


The TRAP command establishes a relationship between a trap vector number 
and a trap handler name. During execution, trap handling procedures are 
activated only if the appropriate TRAP command has been specified. The three 
Honeywell-supplied trap handlers are the Trace Trap Handler, associated with 
trap vector 2, the Floating-Point Simulator, associated with trap vector 3, and 


the Scientific Branch Simulator associated with trap vector 5. 


A-21 AU49 


If the TRAP command is used, the trap handler must be in a load module to 
be loaded. Furthermore, the label of its entry point (i.e., the handler name) 
must be declared at link time with the EDEF Linker command. If more than one 
TRAP command is issued for the same trap vector number, the last TRAP command 
Overrides all previous ones for the same trap number. There are no default 


values for this command. The command format is: 


TRAPAtrap-number,handler-name 


TRAP - Command mnemonic. 
rap-number - The number of the trap vector between 1 and 46. 


handler-name - A string of ASCII characters specifying the name 
(label) of the start of the trap handler. This label must be 
defined in the load module for this application. The three 
Honeywell-supplied trap handlers have the following names: 


l. ZXTRAC - Trace Trap Handler 
2. ZFPSIM - Floating-Point Simulator 
3. ZFBSIM - Scientific Branch Simulator 


TSA 


TSA Command (Trap Save Area Definition) 


The TSA command defines the number and size of the items in the trap save 
area (TSA) list. When a trap occurs, certain pertinent information is stored 
in a trap save area item in main memory. The TSA command allows the adjust- 
ment of the number and size of these items for optimum memory usage. All 
items in the TSA list are of the same size. To find the total size of the trap 
save area, multiply the number of items by the size of each item. The format 


of the TSA command is shown below. 
TSAA[,number of items] [,size] 


TSA -— Command mnemonic. 


items - The number of trap save area items required. The default 
(and the minimum) value is 2. 


size - The size (in words) of one trap save area item. The default 
(and the minimum) value is 8. 


TTY 


TTY Command 


This command identifies each teleprinter device in the application. The 
format of the TTY command is: 


TTYAlrn, level,channel[,label] [,modem] [,speed] 


TTY - Command mnemonic. 


lrn - The logical resource number by which the device is re- 
quested. It must be less than or equal to the hilrn 
parameter of the SYS command. 
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level - 


channel - 


label - 


modem - 


speed - 


VIP Command 


The priority level at which the driver for the device 
will execute. Must be less than or equal to the lolevel 
parameter of the SYS command; it may be the same as 
other communications devices, but must be different 

from the level for the COMM command, and from the levels 
of noncommunications tasks and devices. 


The channel number of the device. 


A label, assumed to be a location definition, which must 


be defined in a load module. This label is the entry point 


of the attention subroutine. The default label for LRN 0 
(Operator's console) is ZIATTN, which is defined in the 
executive load module. The default for other LRN's is 
null. 


A number specifying the type of data set. Possible values 


are: 
0 - direct connect 
1 - Bell 1lxx-type modem (103A,113F,etc). Both the data- 


set-ready and carrier-detect signals needed for a con- 


nection; the lack of both signals is a disconnection. 


- Bell 2xx-type modem (201A,201C,208A,etc.) The data 


No 


set ready signal needed for a connection; lack of this 


signal is disconnection. 


3 or greater - User-defined modem type (see MODEM command). 


The default is modem type l. 


The data rate in bits per second. Possible values are: 


50 300 2400 
tS 600 3600 
100 (default) 900 4800 
134.5 1200 7200 
150 1800 9600 


When this command is processed, an implicit ADMOD command 
is issued to include the teletype line type processor 
(ZOPTTY) in the load list. 


VIP 


This command identifies each visual information projection (VIP) device 


in the application. The format of the VIP command is: 


VIP = 


Irn - 


level - 


7iPAlrn, level,channel[, label] [,modem] 


Command mnemonic. 


The logical resource number by which the device is re- 
quested. It must be less than or equal to the hilrn 
parameter of the SYS command. 


The priority level at which the driver for the device 
will execute. Must be less than or equal to the lolevel 
parameter of the SYS command; it may be the same as other 
communications devices, but must be different from the 
level parameter in the COMM command, and from the levels 
specified for noncommunications tasks and devices. 
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channel - The channel number of the device. 


label - A label, assumed to be a location definition, which must 
be defined in a load module. This label is the entry 
point of the attention subroutine. The default is null. 


modem - A number specifying the type of data set. Possible values 
are: 


0 - Direct connect 


1 - Bell 1lxx-type modem (103A,113F,etc.). Both data-set- 
ready and carrier-detect signals needed for a connec- 
tion; the lack of both signals is a disconnection. 


2 - Bell 2xx-type modem (201A,201C,208A,etc.). The data 
set ready signal needed for a connection; lack of this 
signal is a disconnection. 


3 or greater - User-defined modem type. (See MODEM command.) 
The default is modem type 2. 


When this command is processed, an implicit ADMOD command is issued to 


include the VIP line type processor (ZQPVIP) in the load list. 


* 


*Command (Comments) 


The comments command is used only for documenting the command input listing. 
These comments are bypassed by the CLM. The format of the command is shown 


below. 
*Acomments 


* — Command mnemonic. 


comments - A string of ASCII characters, up to one line in length, 
specifying the comments. 
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APPENDIX B 
PLANNING AND BUILDING WITH EXECUTIVE OBJECT MODULES 


Tne Honeywell-supplied diskette contains a map file, CLMMAP. Members of 
this file document the Linker command and Linker map output for the load 
modules created by Honeywell. This appendix indicates approaches you may use 


to create your own Executive and/or driver load modules from Executive object 


modules. 


CREATING EXECUTIVE LOAD MODULES 


The Honeywell Executive, ZXEX03, consists of the object modules shown in 


Table B-l. 


Table B-l. Executive Object Modules 


Task Manager ZXTSKM.O 
ZXCMGR.O 
ZXCTDA.O 


Clock Manager (basic) 


Clock Manager (time-of-day, 
date) 


Operator Interface Manager 
(console) 


ZIOIM.O 


Operator Interface Manager ZLIOIMP.O 


(panel) 


ZXTRCM.O 
ZIOSUB.O 
ZUERR.O 
ZXINO3.0 
ZXSEM.O 


Trace Trap Handler 


I/O Subroutines 


System Error Handler 


Executive Initialization 


Semaphore Routine 


If you want to omit one or more of the Executive functions, you must build 


your own load module from the Executive object modules. 


Listings of the ZXEX03 modules indicate which modules are being initialized, 
The general procedure for you to follow when preparing your own executive load 
module is to examine the existing load module's initialization code for an 


explanation of its functions. 
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The initialization subroutine table (IST) at the start of the initializa- 
tion module is composed of at least one subroutine entry per module served. 
This means that a module being deleted should have its initialization subrou- 
tine(s) deleted. The converse is also true; a user-created module which had 
initialization requirements could be added to the existing IST (assuming the 


source was available.) 


Figure B-l shows the general structure of initialization subroutines along 
with a detailed sample IST. 


ZXXIST 0 START OF IST 
$AF,0 
<ZXOBS1 OBJECT 1 INITIALIZE 
a PARAMETERS 
0 
<ZXOBJ2 OBJECT 2 INITIALIZE 
0 PARAMETERS 
0 
<ZXOBJ3 OBJECT 3 INITIALIZE 
PARAMETERS 


END OF IST 


SUBROUTINE FOR OBJECT 1 


OBJECT 1 
OBJECT 2 


SUBROUTINE FOR OBJECT 2 


SUBROUTINE FOR OBJECT 3 


OBJECT 3 
OBJECT 4 


INITIALIZATION 
MODULE 


Figure B-l. Initialization Processing 


Subroutines of Honeywell-supplied initialization code are functionally inde- 


pendent. 


To summarize, there are two areas of concern when creating your own load 
module: 
@ Proper Linker commands, especially EDEF's needed by CLM. 


@e Proper IST subroutine entries in new initialization for object 
modules used by new load module. 


Linker commands may be determined by examination of Honeywell-supplied link 


maps (CLMMAP). IST entries may be constructed by examination of Honeywell 


initialization module listings. 
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As an example of a user-created executive load module, assume that the 
application needs the following existing Executive functions: task, both 
clock functions, the operator interface for the console, the error subrou- 


tines. Furthermore, the Buffer Manager is to be added. 


A listing of ZXEX03 must be examined along with the listing for the Buffer 
Manager (ZXBMO1) for IST contents. Note that some of the Buffer Manager 
initialization code must be permanently resident, and cannot be overlaid. A 
new initialization load module is created containing all the required initial- 
ization code for the functions to be included in the new executive load module. 
The IST is located to accommodate the buffer initialization requirements. 


(See Figure B-2.) 


BUFFER 
INITIALIZATION 
(PERMANENT) 


SUBROUTINE FOR CLOCK 
DURING LOADING 


CLOCK 

INITIALIZATION SUBROUTINE FOR BUFFERS 
DURING LOADING 

BUFFER 


INITIALIZATION 


END NEWINT, START | 


Figure B-2. New Initialization Modules 


The link commands (from CLMMAP) for the new load module are all those 
required for the modules to be used. Note that the LINKN for the ZXEX03 
initialization (ZXIN0O3) is not used because the entire Executive module is not 
being used. After all the link commands have been collected (including all 
necessary EDEF's), the Linker is then executed to produce the new load module 


that now contains the required executive functions. 


I/O drivers should remain separate load modules to retain variable selec- 
tion during configuration using the CLM device commands (DEVICE, TTY, VIP, 
BSC), and to maintain compatibility with CLM embedded file/member and start 
address names. 
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APPENDIX C 
APPLICATION CONFIGURATION EXAMPLE 


This appendix provides two examples of application programs. Each example 
contains the Linker, and CLM commands for the application along with a listing 


of the application program. 


The first example presents an input/output pregram, BRDCST, whose purpose 


is to exercise the various device drivers provided with the BES software. 
The second example is a communications test program, COM200. 


CONFIGURATION COMMANDS FOR SAMPLE INPUT/OUTPUT APPLICATION 


The following configuration commands are used to configure the sample 


application, No SYS or TSA command is used since default values are assumed. 


CLOCK 60,50 
ADMOD PROGFILE: ZXEX03,X'1200' (Execution LM) 


ADMOD USRPGS:BRDCST,X'1200! (Application LM) 

TASK BRDCST,1,10,YACT Application LVL 10 (initially active) 
DEVICE CDR,2,7,X'0580' Card reader LVL 7 

DEVICE LPT,5,9,X'1300' Line printer LVL 9 
DEVICE DSK,4,8,X'1200' Disk LVL 8 

DEVICE ASR,0,6,X'1380' Operator's console LVL 6 
EQLRN 3,6 Teletype LVL 6 

ATLRN 6,11 Input Task LVL ll 

ATLRN 7,12 Output Task LVL 12 
ATLRN 8,8 Disk out LVL 8 

EQLRN 9,6 Teletype out LVL 6 

EQLRN 10,6 ASR in LVL 6 

EQLRN 11,6 ASR out LVL 6 

ATLRN 12,13 Output Task 2 LVL 13 
ATLRN 13,14 Output Task 3 LVL 14 
QUIT HLT 


LINK COMMANDS FOR SAMPLE INPUT/OUTPUT PROGRAM 


The following commands are used to produce the load module BRDCST prior to 


invoking CLM to configure an application using the program: 
NAME BRDCST 
LINK BRDCST 
EDEF BRDCST 
MAP 
QUIT 
SAMPLE INPUT/OUTPUT PROGRAM 


The following pages show a documented listing of the BRDCST program. 
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000001 TITLE BRDCST 


000002 * 

000003 * THIS TEST PROGRAM IS A 

000004 * MEDIA TRANSCRIPTION TEST. 
000005 * IT CAN EXECUTE AS AN 

000006 * ON-LINE OR OFF-LINE 

000007 * DRIVER TEST. saves 

000008 * 

000009 * THE OPERATOR WILL TYPE 

000010 * Ox0yoOyYOyY 

000011 * 

000012 x X= INPUT DEV NUMBER Y= OUTPUT DEV NUMBER 
000013 * O= CARD READER 

000014 * 1= TELETYPE 

000015 * 2= DISKETTE IN 

000016 * 3= PRINTER 

000017 * 4= DISKETTE OuT 

000018 * 5= TELETYPE OUT 

000019 * 6= ASR IN 

000020 * 7= ASR OuT 

000021 * 

000022 * 

000023 * LRN O=0OP CONSOLE 

000024 * LRN 1=CONTROL TASK 

000025 * LRN 2=CARD READER 

000026 * LRN 32 TELETYPE IN 

000027 * LRN 4S=DISKETTE IN 

000028 * LRN S=PRINTER 

000029 * LRN 6=INPUT TASK 

000030 * LRN 7EOUTPUT TASK 

000031 * LRN 8=DISKETTE OUT 

000032 * LRN 92 TELETYPE OUT 

000033 * LRN 10=ASR IN 

000034 * LRN 112ASR OUT 

000035 * LRN 1220UTPUT TASK2 

000036 * LRN V3Z=OUTPUT TASKS 

000037 * 

000038 * 

000039 kak kkk 

000040 kkk 

000041 kkk LRN TABLE 

000042 kk 

000043 ** 

000044 * 

000045 * 

000046 0000 2020 BLNKS TEXT ° ’ 

000047 O001 3939 3939 TERM TEXT '99998 TERMINATION CHARACTERS 
000048 * 

000049 * 

000050 0003 DEVT BL RESV 0O 

000051 0003 9d0008 oc <C ROBLK LRN 2 
000052 0004 00713 oc <TTYBLK LRN 3 
000053 0005 OO01B oc <DSKBLI LRN 4 
000054 0006 0026 oC <PRTIBLK LRN 5 
000055 O007 0023 oc <DSKBLO LRN 8 
000056 90008 0033 DC <TTyOuT LRN 9 
000057 O009 0038 oc <ASRINP LRN 10 
000058 QO0OO0A 0043 oc <ASROUT LRN 11 
000059 * 


€-O 
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coM2qn 760622 Lo ASSEMBLER =N200 COMM TEST PROGRAM PAGF 9002 


N00060 O04R NISCOM EAU § 

CONM6t O01R COOH RESV $AF,0 

000NbPR AN19 AON] ne x'O1! WAIT TILL I/0 COMPLETE 
900063 O014 OU0K io] x' aor? DISCONNECT 

000068 An1R YO RESV GAF,O BUFFER 

OGNNGS COLe N00) OC 1 RANGES1 WORD 

OON06& O01 Anga oc x'3a? 

NON067 OOLTE none nec x'o! 

GOONER ON1F oon Nc x'a' 

000069 * * 

900070 * * *IORRECOMMUNICATIONS CONSOLE INPUT* 

00007) * * 

NG007?2 On26 ; COMCT] EQU § 

ONNDO7TS ANd 0000 RESV fAF,0 

OO007TH ONPt 0001 DC xfay? WAIT TILL 170 COMPLETE 
000075 NOP> vVun? de x'adet READ 

ONN07H O23 A1FR NC <COMAFR BUFFER ANDRESS 

000077 anP4a 104A NC 72 RANGFs72 

000078 0025 0030 oC X'30! ECHO, LeFse &C/R 

000079 0026 o00n NC x'o? 

O0n0RN OnA7 aAnNG nC x'oat 

anonna) * * 

OnnNRe2 * * *TORBSCOMMUNICATIONS CONSOLE OUTPUT 

000083 x * 

ON00R4 Q02R comMeoO EQuU § 

OOAORS on28 0000 RESV SAF ,0 

O0ONRS 0029 NOt nc x'oyt WATT TILL 1/0 COMPLETE 
900087 ONPA O44t oc x'aguyt WRITE, CONTROL AYTE RIGHTMOST 
OONHAR NNAR ALA6 NC <LPRUFY BUFFER START ANDRESS 
OO00R9 anec 0049 o¢ 73 7T3SRANGE 

000090 no2en 1030 ae pc x'3o! FCHO, LINE FEEM AND C/R 
000091 OO2E 0000 ne x'o! RESTDUAL RANGE 

090092 N0e2F 0000 Nc x'oat STATUS WORD 

000093 * * 

900094 * * *TORBSCARD READER INPUT 

900095 x * 

000096 0030 CORIN EL $ 

000097 0030 ended RESV SAF,0 

00n09R 031 0003 oc X'od! WAIT 

900099 0032 0302 OC X'3net READ CARDS 

000100 0033 O1CF oc <CDRAUF BUFFER 

000101 0034 0050 NC 80 BOMCHARACTER RANGE 
000102 0035 0000 OC x'o? ASCIY MODE 

0091903 0036 000 0c x'o? 

000104 0037 O00n oc x'or 

000105 * * 

000106 * * *JORRELINE PRINTER QUTPUT 

000107 x * 

000108 0038 LPTOUT EQU $ 

000109 on38 000 RESV SAF,0 

000310 0039 001 nec x'ot! WAIT 

NOOT11 ON3A Oe4} oc x'eai! WRITE/CONTROL BYTE RIGHTMOST 
000112 Q03R 0146 oc <LPBUF 1 BUFFER 

9001313 OO3C 0049 oc 73 

000114 0030 0000 pc xto? 

000115 ON3E 0000 oc xo! 

000116 OO3F 0000 nc x'o! 

000117 * * 

000118 * * *xBEGIN 


000119 * * 
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000120 
000121 

000122 
000123 
000124 

000125 
000126 
000127 
000128 
000129 
000130 
000131 

000132 
000133 
000134 
000135 
000136 
000137 
000138 
000139 
000140 
000141 

000142 
000143 
000144 
000145 
000146 
000147 
000148 
000149 
000150 
000151 
000152 
000153 
000154 
000155 
000156 
000157 
000158 
000159 
000160 
000161 

000162 
000163 
000164 


000165 
000166 
000167 
000168 


000169 
000170 


000171 


000172 


o09c 
0090 
OO9E 
OO9F 


00a0 
Q0A1 
O0A2 
O0A3 


OOA4 
OOAS 
O0A6 
00A7 


OOA8 
QOA9 
OOAA 
OOAB 


ooac 
OOAD 
OOAE 
OOAF 
0080 
0081 
0084 
0087 
0089 
oosc 
O0BE 
00¢c1 
00c3 
00c6 
00c7 
OOCA 
O00Cod 
OOCcE 
00D1 
0003 
0006 
0008 


0000 
0000 
0600 
O13F 


0000 
0000 
0700 
0150 


0000 
0000 
0¢00 
0161 


0000 
0000 
0000 
0171 


0000 
0001 
0001 
00p4 
0065 
0000 
2063 
6472 
2074 
6E30 
2064 
696E 
2070 
3033 
2064 
6F75 
ODOA 
2074 
7574 
2061 

6E30 
2061 


7264 
3030 
7479 
3100 
6973 
3032 
726€ 


6973 
7430 


7479 
3035 
7372 
3600 


7372 


2072 
2069 
6820 
7472 


6B20 
3400 


2 06F 
2069 


206F 


* 
* 
* 


TASK O01 


2 
¥ 


* 
TASK C2 


* 
when 
ae 
Raat nan 
t 


TASK O03 


* 
ehhh t 
at 
ake 
* 

TASK C4 


ESS-AG 


OUTMSG 


RESV 
oc 
oc 
oc 


RESV 
oc 
oc 
oc 


TASK 1 (INPUT) REQUEST BLOCK LRN 6 


140 

x*0000° 
x* 0600‘ 
<INSTRT 


TASK 2 COUTPUT) REQUEST BLOCK LRN 7 


1-0 

x* 000° 
x*0700°* 
<OUTSTR 


OUTPUT2 TASK REQUEST BLOCK 


RESV 
bc 
oc 
oc 


140 

x* 0000° 
x*0c00°* 
<OUT2ST 


OUTPUT3 TASK REQUEST BLOCK 


RESV 
oc 
o¢ 
oC 


RESV 
oc 
oc 
oc 
oCc 
RESV 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 


oc 
TEXT 


TEXT 


TEXT 


10 

x*Q0u0°* 
x*Q000° 
<OUT3ST 


START-UP L/0 REQUEST BLOCK (OUT) 


120 

x*or* 

x* C001 * 
<OUTMSG 

101 

3-0 

" erd rdr=0' 


" tty in=1' 

* disk in=2° 
" prntr=3! 

* disk out=4! 


Z7'OD0A° 
* tty out=5' 


* ase in=6° 


" asr out=7"* 


LRN O 
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000173 
000174 


000175 
000176 
000177 
000178 
000179 
000180 
000181 
000182 
000183 
000184 


000185 
0001 86 
000187 
000188 
000189 
000190 
000191 
000192 
000193 
000194 
000195 
000196 
000197 
000198 
000199 
000200 
000201 
000202 
000203 
000204 
000205 
000206 
000207 
000208 


000209 
000210 
000211 
000212 
000213 
000214 
000215 
000216 
000217 
000218 
000219 
000220 
000221 
000222 
000223 
000224 
000225 
000226 
000227 


0008 
O0o0od 
OODE 
00¢€1 


OOE5 
O0E6 
OOE7 
O0E8 
O0E9 
OOEA 
OOED 
OOFO 


OOF1 
OOF2 
OOF3 
O0F4 


OOFS 
OOF6 
OOF? 
OOF8 
OOF9 
OOFA 
OOFD 
OOFE 
0100 
0101 
0104 
0105 


0106 
0108 
010A 
010¢ 
O10E 


7574 
Op0A 
2074 
306E 
3079 


0000 
0001 
0002 
OOE dD 
0008 
0000 
2020 
2020 


OOAC 
O0E5 
0000 
0000 


0000 
0001 
0041 
OOF b 
0011 
0000 
0041 
6465 
0000 
2065 
3000 
0000 


0001 
0002 
0005 
0040 
OOE F 
OOF 0 


CcC80 
9870 
9F00 
9F00 
9F00 


3037 


7970 6520 
3079 3079 


2020 2020 


7630 


7272 6F72 


OOF2 
2020 
OOEE 
OOEF 
OOFO 


® 
* 
* 
INPM SG 


INMS ¢ 


RRM SG 


ERROR 


DEVA SN 


STAT US 


* 

* 

SLVC 11 
SLVC T2 
$LVC TS 
SLWBT 
OUTS Ke 
OUTS K3 


* 
* 
* 
* 
* 
8 


RDC ST 


DC z*0p0a* 


TEXT ° type OnOyOyO0y’ 


STARTUP I/0 REQUEST BLOCK 


RESV 1,0 

oc x*O1* 

oC x’ 0002' 

oc <INMSG 

oC 8 

RESV 3,0 

TEXT : 

oc <MESSAG PARAMETER LIST 
oc <INPMSG 

oc 0 

DC 0 WORK WORDS (PREVICUS 


1/0 ERROR MESSAGE I10RB 


RESV 1,0 

oc x*o1' 
DC x*C041° 
oc <ERROR 
DC 17 

RESV 3,0 

OC x*C041°* 


TEXT ‘dev=' 
oc x* 0000 
TEXT °* errors?’ 


oc x*0000* 
EQU 1 
EQU 2 
EQU 5 


EQU x' 40° 
EQU <INMSG+2 
EQU <INMSG+3 


TYPE STARTUP MSG/WAIT FOR REPLY 


LOB $B4-<PARLST+3LVCT1 
LDR $R1-=2*2020' 
STR BRI-<INMSGHI 
STR SRIs<INMSG#2 
STR S$RVA<SINMSG43 


WORD TO00) 
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0000 


000343 0181 
0183 
000344 0184 
000345 0186 
000346 0188 
000347 0189 
000348 01886 
000349 
000350 
000351 
000352 
000353 
000354 
000355 
000356 
000357 018D 
O18E 
000358 O18F 
000359 0191 
000360 0193 
000361 0195 
000362 0197 
000363 0199 
000364 0198 
000365 
000366 019¢ 
000367 
000368 
000369 
000370 
000371 
000372 
000373 
000374 019d 
ERR COUNT 


8204 
0020 
0580 
B844 
8AD 3 
BF44 
0380 


8951 
3030 
9FO00 
AFOO 
cF8d 
C880 
D380 
cc8a 
8 384 


0000 


0150 
O13F 
0106 


0001 


0186 
0005 


0005 
0000 


10K 


RROLT 


LB 


BBF 
LDR 
INC 
STR 
LNJ 


SB4.$LVCTI,x*UU20! 


<NOTOSK 
$R3,$84 SL VCTS 
=$R3S 
SR3-384.$LVCTS 
$B85-<Z2XTERM 


00 BIT TEST 


NOT A DISK IF BITz0 

LOAD CURRENT SECTOR INTO R3 
BUMP IT BY 1 

PUT IT BACK WHERE IT BELONGS... 
NOW YOU CAN POST + TERMINATE 


THE FOLLOWING CODE IS AN ERROR ROUTINE 
IT DISPLAYS THE DEVICE NUMBER AND THE 
STATUS CCDE ON THE OP CONSOLE THEN IT 
RETURNS CONTROL AT THE POINT THE 1/0 
WAS REQUESTED, IT RUNS AT THE 
LEVEL OF THE OFFENDING ROUTINE. eence 


ORDER 


UBT 


STR 
STR 
sT6 
LAB 
LNJ 
LoB 
JMP 


RESV 


XDEFS 


XDEF 


XLOC 
END 


=$R142°3030' 


S$R1-<STATUS 
SR2e<DEVASN 
SB4-<STORBS 
S$B4e<ERRMSG 
$B85e<Z10REQ 
SB4e¢<STORBS 
$B4 


1,0 


AND xLOCcs 


MAKE IT TYPEABLE 


THROW STATUS IN BJ FFER 
THROW DEVICE NUMBER IN SAME 
HOLD RETURN ADDRESS 
AND SETUP FOR 
THE ERROR TYPEOUT 
LOAD RETURN ADDRESS IN B4 
GO BACK AND RE“ ISSUE ORDER 


B4 HOLD WORD 


OUTSTReINSTRI,BROCST 


ZITYPRe ZXRQSTeZIOREQs ZXTERM 


BRODCST 


CONFIGURATION COMMANDS FOR SAMPLE COMMUNICATIONS APPLICATION 


The following commands are used to configure the sample communications 
application. The absence of a TSA command indicates that default values were 


taken. 


LACT CLMCOMM: COMM 

ELACT 

SYS 16,22,SAF 

OIM 5,11 

COMM 7 

TTY 4,10,X'FDOO',,0 

ADMOD PROGFILE: ZXEX03,X'0400' 
ADMOD LINKFILE:COM200,X'0480' 
CLOCK ,50 

DATE '760622','1200' 

DEVICE KSR,0,6,X'0500' 

DEVICE LPT,2,8,X'1380' 

DEVICE CDR,3,9,X'1300' 

TASK GLUE,6,12,YACT 

QUIT HLT,MAP 


LINK COMMANDS FOR SAMPLE COMMUNICATIONS PROGRAM 


The following commands are used to produce the load module COM200 prior to 
invoking CLM to configure an application using this program: 
NAME COM200 
LINK COM200 
MAP 


EDEF GLUE 
QUIT 


SAMPLE COMMUNICATIONS PROGRAM 


The following pages show a documented listing of the COM200 pagram. 


xx =6 CGRP OO LItkK Mop 
K*ESTART 

wEL OY acan 

#KHTGH 0246 


K*CURRKENT 246 


KKEXT OEFS 

P 7BCGMEHR 8 Gaano 

P ZHREL O00 

* COMPO 0690 
GLIk Geao 


KAUN EEF 

kx COrend OfOG 
ZIGRER 6191 
ZXxCTOOH G11E 
7xXxC*GR 0127 


I¥G UNDEF 
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CamMpon 


9000001 
on0n0e 
OnNN0ns 
oannod 
onnnns 
090006 
600007 
000008 
000009 


000010 
nn001 14 
0n0012 
000013 
an0014 
annnys 
000016 
900017 
000018 
900019 
090020 
on00es 
990022 
900023 
000024 
N00025 
900026 
900027 
a0agNeR 
900029 
900030 
090031 
900032 
000033 
an00g4 
0900035 
090036 
000037 
OO003A 
900039 
9900040 
900044 
0n004ea 
annnds 
on9004d4 
n00045 
900046 
900047 
QONQO4A 
yangag 
0n00so 
o00nst 
n000se 
000053 
0on00nsd 
000055 
900056 
0010057 
O0GN5B 
on0ns9 


TAN622 


0000 
ong) 
anne 
0003 
0004 
0005 
N006 
0007 


0008 
0009 
NNOA 
Ong 
On0C 
anon 
QO0E 
ONUF 


00190 
oOni1t 
0012 
ON13 
0014 
0015 
00146 
nn17 


Lo ASSEMALER}=1200 


noud 


0on00 
0004 
9002 
9003 
onta 
0005 
0006 
0007 


qqan 
90090 
0001 
00902 
O148 
0096 
9030 
oo0n 
oan 


O0GR 
agaa 
0004 
0041 
OYAC 
ogi4a 
0030 
anna 
0nnn 


09010 
ag00 
0001 
O4aa 
ngna 
nan] 
0030 
aoao 
00090 


* 
* 
* 
Z 
Z 
Zz 
Z 
Z 
Zz 
Z 
r4 


K 


* 
* 
* 
K 


* 
* 
* 


Cc 


» 


COMM TEST PROGRAM 


TITLE 


TRLNK EQU 
TRCT1 EQU 
IRCT2 EQU 
TRBAD FQU 
TRRAG EU 
IRNVS EQU 
IRRSR EAU 
TRST1 EQu 


SRIN EQU 


SROUT EQY 


ONCOM EQU 


PAGE 0001 


COMP00,'7h0b22' 
* 

*#EXTERNALS 

* 

ZINREQ 

Z2xXxCTOD 

Z7¥CMGPR 


GLUE 


* 


COMM TEST PROGRAM 


INPUT@OUTPUT DRIVER 
CLOCK MANAGER 


*TORASLARELED AISPLACEMENTS 


* 

9 
ZIRLNK+BAF 
ZIRCT1I+41 
ZIRCT?P +1 
ZIRRAN+S AF 
ZIRRNG+1 
ZIRDVS+1 
ZIRPSR+1 

* 


*TORASCONSOLE INPUT 


* 
§ 
$AF,0 
xtor! 
X'02! 
<KSRRUF 
6 

x'3o! 
x'or 
X'ot 

* 


*TORRASCONSOLE OUTPUT 


* 

$ 
f$AF,O 
x'oi' 
xfayt 
<LPALUF I 
en 
x'Bae 
x'gt 
x'ot 
x 


LINK 

CONTROL WORD 1 
CONTROL WORD 2 
BUFFER ADDRESS 

RANGE 

DEVICE SPECIFIC 
RESIDUAL RANGE 
SOFTWARE STATUS WORD 


WATT TILL 1/0 COMPLETE 
READ 

BUFFER ANNRESS 

RANGE IN AYTES 

C/R, LINE FEED, &ECHO 
RESIDUAL RANGE 

STATUS 


WATT 

WRITE 

RUFFER 

RANGE IN AYTES 
C/R, LeFoe R ECHO 


*TARBSCONNECT COMMUNICATIONS CONSOLE* 


* 

& 
$AF,0 
x'o.t 
x'aoa! 
$AF,9 
{ 
x'3o' 
x'o' 
ytot 

* 
*TORREDISCONNECT 
* 


WATT TILL I/0 COMPLETE 
CONNECT 


RANGE=St WORD 


COMMUNTCATIONS CONSOLE* 


6-9 
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000060 
000061 

000062 
000063 
000064 
000065 
000066 
000067 
000068 
000069 
000070 
000071 

000072 
000073 
000074 
000075 
000076 
000077 
000078 
000079 
000080 
000081 
000082 
000083 
000084 
000085 
000086 
000087 
000088 
000089 
000090 
000091 
000092 
000093 
000094 
000095 
000096 
000097 
000098 
000099 
000100 
000101 

000102 
000103 
000104 
000105 
000106 
000107 
000108 
000109 
000110 
000111 

000112 
000113 
000114 
000115 
000116 
000117 
000118 
000119 


0008 
000c 
0000 
OOO0E 
OOOF 
0010 


0013 
0014 
0015 
0016 
0017 
0018 


0018 
O01Cc 
0010 
OO1E 
OO1F 
0020 


0023 
0024 
0025 
0026 
0027 
0028 


0028 
002c 
0020 
Q02E 
O02F 
0030 


0033 
0034 
0035 
0036 
0037 
0038 


0038 
003¢ 
0030 
OO3E 
OO3F 
0040 
0041 


0043 
0044 
0045 
0046 
0047 
0048 
0049 


0048 
004¢ 


0000 
0001 
0202 
004 C€ 
0050 
0000 


0000 
0001 
0342 
0048 
0050 
0000 


0000 
0021 
0402 
004C 
0050 
0000 


0000 
0021 
0801 
O04C 
0050 
0000 


0000 
0001 
0541 
0048 
0050 
0000 


0000 
0001 
0941 
0048 
0050 
0000 


0000 
0001 
0a02 
004¢ 
0050 
0044 
0000 


0000 
0001 
0801 
004¢ 
0050 
0044 
0000 


0041 


CRDBLK 


* 


TIYBLK 


* 


OSKBLI 


* 


OSKBLO 


* 
PRIBLK 


* 
TTYOUT 


* 
ASRINP 


* 
ASROLT 


* 


BUFFEP 
BUFFER 


146 
x*Q1° 
x*Q202° 
<BUFFER 


1,0 

x* 0021 ° 
x*0402¢ 
<BUFFER 


1,0 
x'0Q021° 
x* 0801? 
<BUFFER 
80 

3,0 


1,0 
x'Qi' 
x'Q541¢ 
<BUFFEP 
80 

3,0 


1,0 
x*ot' 
x*0941 ° 
<BUFFEP 


<BUFFER 
80 
x*' 0044 ° 
20 


1,0 
x*oi' 
x*0B01° 
<BUFFER 


x*0041° 
80 


CARD READER 
1/0 

CONTROL 
BLOCK 


TTY CINPUT) 
1/0 
CONTROL 
BLOCK 


DISKETTE INPUT 
1/0 

CONTROL 

BLOCK 


DISKETTE OUTPUT 
1/0 

CONTROL 

BLOCK 


PRINTER 
1/0 
CONTROL 
BLOCK 


TTy OUTPUT) 
1/0 

CONTROL 
BLOCK 


ASR CI NPUT) 
1/0 

CONTROL 
BLOCK 


ASR (QUTPUT) 
1/0 

CONTROL 
BLOCK 


CARRIAGE CONTROL CHARACTER PRINT + SPACE 


OT-O 
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COM200 76062? LA ASSEMALER=1200 COMM TEST PROGRAM PAGE 0003 


000129 O40 CRAG 0010 GLUE LAB $R4,<CONCOM GFT CONNECT IORB 
on012a1 And? D3ARN 1000 X LNJ $BS,<ZINRFO AND CONNECT COMMUNTCATIONS CONSOLE 
000122 AO44 FRAN 00K7 LNJ $A7,<CLFARR CLEAR MESSAGE RUFFER 
000123 O04H 820 0236 QUERY LAR $R3,<QUFS,$R2 GET MESSAGE TEXT 
000124 1048H RFeN 0147 5TR SRB, <LPRIIFO,$R2 AND STORE ADDRESS 
900125 NO4A PEC ADV $R2,1 ADD 1 TO COUNTER 
010126 O04R 2Dn4 CMY $R?,4 B CHARACTERS? 

000127 NN4C O91 FFFO BNE QUERY IF NOT, GET MORE 
100128 OO4EF B00 NAIC LDR $R3,<RELLS GET RELLS 

000129 0n50 RF20 0147 STR $R3,<LPRUF2,$R2 AND STORE IN BUFFER 
000130 OnSe@ CRAN N00A LAB $R4,<KSROUT 

000131 054 4co9 LDV $R4,9 

oONt3se OSS CF4d Onna STR $R4,8ROZ7TRRNG 

000133 0057 0380 0n00 Y¥ LANJ $R5,<Z1TOREQ PRINT MESSAGE ON KSR 
000134 0059 OFA! 0007 B KRE AD AND THEN GO TO READ KS 
000135 OnS5& C880 001A OIScoOK LAR $B4,<PISCOM GET DISCONNECT IORB 
000136 050 0380 anno x LNJ $85, <ZTOREQ DISCONNECT COMM CONSOLE 
000137 OOSF OF8&1 01E3 8 FINTS 

900138 061 CRAO 000 KREAD LAB $R4,<KSRIN LOAD KSR INPUT IORB 
000139 0063 M3a0 0000 x LNJ $BS,<ZIOREQ READ COMMAND 
000140 0065 OFS! 0050 B GETCH 

000141 * * 

000142 * * *xERROR ROUTINES 

000143 * * 

000144 067 CaO 0008 CLEARR LAB §RU,<kKSROUT GET IORA 

000145 0969 ARAN 0146 LAB $R2,<LPRUIF 1 GET CONTROL BYTE 
000146 G06R AFCY 0003 STB $R82,8R4,ZTRRAD AND STORE ADDRESS 
100147 O06D 8752 CL 2$R2 CLEAR COUNTER 

000148 O06EF BBBO 0147 LAR $A3,<LPAUF2 GET LPARUF2 

000149 O70 2Ced4 LDV $R2,36 SET COUNTER TO 36 
000150 0071 O3A0 OL4E LNJ $85,<SPACITT GO CLEAR BUFFER 

000151 0073 Aa752 CL =fRO CLEAR COUNTER AGAIN 
000152 0074 8387 JMP $R7 AND GO BACK WHERE YOU CAME FROM 
000153 * * 

900154 0075 4COF ERRMSG LOV $R4,15 

000155 0076 CF44 90nd STR $R4,$R4,ZIRRNG 

000156 O07R B20 021n LOR $R3,<MSG61.,.8R2 GET MESSAGE TEXT 
000157 OO7A BF20 OLA7 STR $R3,<LPRUF2.§$R2 AND STORE ADDRESS 
000158 O07C e2E0] ADV $R2,1 ADD 1 TO COUNTER 
000159 O007D ApO7 cy $R2,7 14 CHARACTERS? 

000160 O007E 0981 FFFG6 BNE ERRMSG IF NOT, GET MORE TEXT 
000161 0080 0380 0000 x LNJ $BS,<ZIOREQ ELSE,GO PRINT IT 
000162 0082 F380 0067 LNJ $B7,<CLEARR CLEAR BUFFER AGAIN 
000163 0084 &752 ion =ER 

000164 0085 OFA FFCO 8 QUERY 

000165 * * 

000166 0087 4COR DONMES LOV $Ru,11 

000167 0088 CF4u 0004 STR SR4,$R4,Z7IRRNG 

000168 onsA 8820 0224 LOR $R3,<MS62,$R2 GET MESSAGE TEXT 
000169 08C BF20 O1A7 STR $R3,<LPBUF2.$R2 AND STORE ADDRESS 

000170 OOf8F 250! ANY $R2,1 ADD 1 TO COUNTER 
000171 OOBF e2hod CMV $RO,4 B CHARACTERS? 

000172 0090 O9f1 FFFE6 BNE DONMFS TF NOT, GET MORE TEXT 
000173 0092 R&00 OA1C LDR $R3,<RELLS 

000174 0094 BF20 O1A7 STR $R3,<LPRUF2,$Re2 

000175 0096 0380 0000 x LANJ $A5,<ZINREO GO PRINT MESSAGE 
000176 0098 OFB81 FFCe A DISCOM AND THEN GO DISCONNECT COMM CONSOLE 
000177 * * 

000178 oa09A &a4COD DEVERR LOV $R4O,13 


000179 CO9B CF4ad 0004 STR §$R4,S5RU,ZIRRNG 


Eke 


6vNY 


CoO¥200 


NoO1TaN 
000184 
ANN? 
NOON1RS 
ONN,AU 
6001TBS 
CO0YRA 
0001A7 
90018a 
Q00189 
000190 
on019t 
0N019? 
000193 
ACOT9a 
000495 
NNN196 
000197 
0001968 
090199 
n00200 
O0N0AN1 
NON202 
000203 
000204 
000205 
000206 
000207 
N0020AR 
000209 
000210 
ON0A11 
000212 
000213 
OnnNAa1Yg 
000215 
000A16 
000217 
00N21A 
090219 
000220 
0002e1 
000222 
000223 
090224 
000225 
000226 
000227 
000228 
000229 
000230 
000231 
000232 
000233 
000234 
000235 
000236 
000237 
000238 
000239 


TANHC?R 


00eor: 
O09OF 
ana 
NOAA? 
O0A3 
00S 
OOAT 
OORS 


onad 
OObC 
OO AF 
NORD 
NAR? 
oaRrYg 


ANR6 
ORR 
NORA 
oOnRC 
OORE 
coca 
00Ce 
N0C4 
00C4 
o0ca 
OO0CA 
00CcCc 


O0CE. 
0000 
COD2 
NNDa 
N0D6 
0008 
00n9 
OODA 
NONC 
NODE 
ONE0 
O0E1 
OOF3 
O0ES 
OOE6 
O0ES 
QOEA 
OOER 
OOEC 
OOEE 


OOFO 
00F2 
OOFG 
O0F6 


Lo 


BRO 
RFA 
ern, 
enoe 
N9R1 
N3aN 
6752 
QFRI 


F3a0 
FRY 
F3a0 
OFRI 
FAN 
OF BY 


ARROL 
H900 
non) 
F900 
O9BR) 
RENO 
R900 
O9R] 
RAND 
BO00 
O9R} 
OF RY 


CHAO 
N3R0 
BANO 
ROTO 
0901 
8752 
R754 
1903 
OF BI 
R2ad 
eEO1 
RIF OQ 
Q9RY 
enso 
9901 
OF AY 
C852 
enso 
0901 
OF 81 


CBa0 
ABB0 
AFC4 
4E0} 


ASSEMRLER e200 


N2PR 
OTAT 


FFFEA 
000 


FFON 


0067 
FFDA 
0067 
FFCU 
ONAT 
FEES 


O1A2 
O1F7 
FFEF 
023D 
FFEF 
01A3 
O23F 
FFEQ 
OL Ad 
O23F 
FFE 
0001 


0030 
0000 
O1CF 
Ded 
0090 


0003 
FEDS 
O1CF 


2000 
0006 


0009 
FFFS 


0003 
FFEF 


0028 
0146 
0003 


cOvm TEST PROGRAM 


* 
TWIG! 


T¥IGe 


TWIGS 


GETCH 


* 
* 
x 
CARNRD 


CHECK 


COUNT 


* 
COMOUT 


LMR 
STR 
ANY 
CMV 
BNF 
LNT 
cL 


PAGE 0004 


$R3,<MS63,5R2 


FRB, <LPRUF A, SRO STORE ANDRESS OF MESSAGE 
FR2,1 ADD 1 TO CQUNTER 

FHAPb 12 CHARACTERS? 

DEVERR IF NOT GET MORE TEXT 

FRS,<ZTOREO OTHERWISE, GO PRINT IT 
=$Re 

QUERY 

* 

$R7,<CLFARR 

NOMNMES 

*R7,<CLFARR 

FRRMSG 

$A7,<CLEARR 

DEVERR 

* 

*REAND CONSOLE JNPUT* * 
* 

$R3,<KSRRUF GET 1ST TWO CHARACTERS 
$R3,<TERM 

TWIG1 

$R3,<CHe COMPARE TO CA 

TwIGe WRONG COMMAND 
$R3,<KSRBUF +] GET 2ND TWO CHARACTERS 
$R3,<CH4 COMPARE TO RO 

TWIG2 WRONG COMMAND 
$R3,<KSPBUF 42 GET NEXT TWO CHARACTERS 
$R3,<CHO COMPARE TO IN 

TWIG? WRONG COMMAND 

CARDRN 


* 
xREAD CARDS 
* 
SRO, <CDRIN GET IORB 
$B5,<ZIOREO READ A CARD 
$R3,<CORBUF LOAD IT IN 
$R3,22'1D020' COMPARE TO EOF 
COMQUI IF EOF, GO TO COMM CONSOLE 
=$Re2 
2$Ra 
$RL,CHECK IF NO ERROR, GO TO CHECK 
TWIG3 OTHERWISE, DEVICE ERROR 
$R3,<CORBUF.SR2 
$R2,1 
$R3,=2Z'20' 
COUNT 
#R2,R0 
COMOUT 
CHECK 
$RU,ZSSR2 
$R2,80 
COMOUT 
CHECK 
* 
*xSEND CARD INPUT TO COMMUNICATIONS DEVICE* 
* 


$B4,<COMCO GET IORB 
$B82,<LPBUF1 GET CONTROL BYTE 
$82,884,ZIRBAD AND STORE ADDRESS 
$R4,1 


cl=0 
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COM200 


000240 
000241 
000242 
000243 
000244 
000245 
000246 
000247 
000248 
000249 
000250 
000251 
000252 
000253 
000254 
090255 
090256 
090257 
000258 
000259 


000260 


090261 
0002062 
000263 
000264 
000265 
090266 


000267 


000268 
000269 
000270 
000271 
090272 
000273 
Onn0e74 
000275 
000276 
000277 
000278 
900279 
NOn2eR0 
0n0281 
0002BR2 
0002783 


ONOGAd 
OON2RS 
ON02R6 
OND2RT 
CON2RB 
000289 


090290 
90294 


760622 


OOF7 
OOFS 
OOFA 
OOFC 
OOFE 
OOFF 
0100 
0102 
0104 
0106 
0108 


O10A 
010C 
0100 
O1O0F 
0110 
0112 
0115 
o114 
N116 
O117 
01148 
OLA 
oF 1C 
0110 
O11F 
0120 
N1el 
9123 
0124 
0126 


0128 
128 
o12ac 


O12€ 
O12F 
0131 
01432 


04134 
01346 
0137 
0139 
a1 3R 
013C 
01 3E 
OL 3F 
Odd 
142 
O144 
ayas 
0447 
GiUR 
O1GA 
O14ac 


L6 


Cfdu 
8752 
8820 
BF 20 
2E01 
ened 
0981 


“D380 


1981 
F3CO0 
OF al 


CB80 
8752 
RRBO 
2coe8 
D3A0 
BFRY 
1F 00 
AF uO 
1F00 
icoa 
CRAG 
D3aa 
1003 
cCReG 
AF RU 
1FO0 
&F4O 
1FOG 
CRAN 
H3aC 


Cha 
ARRO 
AFCA 


a7T5e2 
BPR 
eCed 
N3ZaC 


cKeao 
Ea&Sy 
Reon 
BFCO 
9500 
RF a0 
{FAQ 
caan 
Fasda 
AFCO 
7500 
KFan 
7TFOO 
Noe 
1901 
OF eB 4 


ASSEMBLER=0200 COMM TEST PROGRAM 
0004 STR 
CL 
O1CF COMMO LOR 
O1A7 STR 
ADV 
CMV 
FFF9 BNE 
0000 x LNJ 
FFAO BNEZ 
0003 LNJ 
FFCS B 
* 
* * 
* 
0000 Xx GETIME LAB 
Ck 
O22E LAR 
LOV 
O14E LNJ 
RSTR 
0119 SAVE 
LDV 
O22E LAR 
0000 x LAL 
LOV 
0900 x LAB 
RS8TR 
OLOF SAVE 
Oesi LAR 
0000 x LNJ 
* 
O05 PRTM{ LAR 
0146 LAR 
0003 STR 
* 
ZAPIT CL 
O1A7 AB 
LOV 
O( GE LANJ 
* 
910C PRTMO LOR 
LOR 
OPE LOR 
NOFS RSTR 
OO6A Save 
N12 LOR 
LOR 
OOFF RSTR 
0967 SAVE 
n0na x LNJ 
ONOR BEZ 
FFGS B 


PAGE 0005 


S$R4,8RU,Z7TRRNG 
eRe 
$R3,<CDRBUF.§R2 
SR3,<LPBRUF2.$R2 
SR2,1 

$R2,36 

COoMMn 

SBS, <ZIORER 
SRL, TWIGS 
FB7,GETIME 
CARDRD 

* 

*aGET DATE AND TIME 
* 

€R4,<Z2xXCTOD 
=ER 

$B3,<TIMER 
fR2,8 
$AS,<SPACIT 
$R4,=Z7'1F00! 


TIMER,=7'1F00! 


FRi,=d 
$RU,<TIMER 
ERS,<72XCMGR 
FRL,53 
$R4O,<7XCTOD 
$Ra,=Z7'1F00' 


TIMER4+3,2=Z'1F00' 


$B4,<TIMER43 
$R5,<Z7XCMGR 

x 

$R4,<LPTOLUT 
$R2,<LPARLIF 
€R2,4hR4,7IRRAN 
* 

2$R2 
$R3,<LPRUF 2 
$R2,=36 
®RS,<SPACIT 

* 

$R4,SLASH 

FRO, =FRU 
$R3,<TIMER 
TIMER 41,=7'0500' 


LPKUF2,=Z'1F00! 
#R4,COLON 
FR6,=ER4 
TIMER+3,=57'7500! 
LPRUF2+6,57'7F 00! 
5RAS,<7TNREQ 


ER1L,PRIMT 
TWIGS 


CLEAR R2@ COUNTER TO ZERO 

GET TWO CHARACTERS FROM CORBUF 
AND STORE IN LPBUF2 

ADD 1 TO COUNTER 

COMPARE TO 36 

IF NOT 36,GET MORE 

QTHERWISE SEND TO COMM DEVICE 


AND PRINT IT* 


GET DATE AND TIME 


RESTORE IN R#REGISTERS 327 
AND SAVE IN TIMER 


PUT 4 IN RI 

GET ADDR OF DATE 
CONVERT PDATF TO ASCII 
PUT 3 IN Ri 


GET ANDR OF TIME 
CONVERT TIME TO ASCTY 


GET IGQRB 
GET CONTROL BYTE 
STORE ADDR 


SET Re TQ 0 

GET LPT BUFFER 

PUT 36 IN R2 

CLEAR BUFFER TO SPACES 


GET A SLASH 

ONE FOR R6 TNO 

LOAD YEAR IN R3 

LOAD REST OF NATE IN RS AND R7 


AND SAVE R3=R7 INTO LPRUF2 


PUT A COLON IN RY 
AND ALSO TN R6 

GET TIME AND PUT IN OTHER R=REGISTERS 
AND SAVE INTO LPBUF2 


GO PRINT IT 
IF STATUS OKs GO ON 
OTHERWISE, DEVICE ERROR 


€T-9 


67Nw 


cCOmMa00 


N00P9P 
090093 
000294 
na02e95 
000796 
090297 
000298 
100299 
060300 
000301 
000302 
000303 
0n03NnYg 
000305 
00N3N6 
000307 
000308 
090309 
000310 
Oon314 
000312 
000313 
000314 
ono0s1s 
000316 
000337 
000318 
000319 
00060320 
000321 
000322 
000323 
000324 
900325 
000326 
000327 
000328 
000329 
090330 
000331 
000332 
000333 
000334 
000335 
000336 
000337 
000338 
000339 
000340 
000341 
000342 
000343 
000344 
000345 
000346 
000347 
000348 
000349 
000350 
000351 


76062? 


C14E 
0150 
0151 
9152 


01523 
0155 
0157 
0159 
015A 
945C 
N15E 
OLSF 
0140 
N16e2e 
0164 
O1b6 


0167 
0169 
N16A 
0168 
016% 
O1oF 
0171 
9173 
0174 
0176 
0177 
0179 
01786 
OL7C 
0170 
017F 
0181 
0183 
0185 
0187 
0189 
0188 
018C 
O18BE 
0190 
0192 
0193 
0195 
0197 
0198 
0199 
0198 
019C 
O19E 
O1A0 


Lé 


OYGE 
FROO 
FFeR 
COFF 
RZAK 


CREO 
ARBO 
AFCA 
&752 
BRED 
BF2Q 
ef O4 
enhed 
OFA 
D3RO 
1981 
B3AT 


RBRO 
R752 
2Ceu 
p3ao 
CRAO 
ARBO 
AFC4 
4CO7 
crud 
8752 
B20 
PF 20 
260! 
2003 
098} 
CRRO 
C380 
1901 
OF al 
8900 
0981 
e752 
Ora! 
CH80 
D3A0 
a752 
8820 
BF 20 
2E01 
2001 
0901 
2d2u 
0981 
F3CO 
OF a1 


ASSEMRLER|02N0 


aR4o 


O03R 
O1A6 
0903 


O1CF 
O1A7 


FFF 
0090 x 
FFUn 


OLAT7 


OL4E 
0028 
O1AG 
0003 


0004 


023A 
O1A7 


FFFQ 
9028 
0000 x 
QO0A 
FF2C 
O1F7 
0009 


FERS 
0020 
0000 x 


O1F8 
O1CF 
FFED 
FFF6 


FF 6B 
FFED 


come 


* 


SPACIT 


$A 


PRINT 


PRINT) 


* 
* 
* 


comMau) 


COMQUE 


ENDIT 


COMIN 


COMMI 


TEST PROGRAM 


E QU 
LDR 
STR 
BNEZ 
JMP 
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x 
g 

FRA, <RLANKS 
FRH,FR3.- FRO 
ERP, >e8A ; 
§RS 

x 


*PRINT CARD INPUT 


* 

$R4,<LPTOUT 
$R2,<LPRUFI 
$R2,8R4,ZIRAAN 
=4Re2 

ERB, <CORBUF, SRO 
$R3,<LPBUFO,&RO 
SRO, 4 

ER2, 36 

PRINT1 
$85,<Z710REQ 
FR{,TWIG3 

$R7 

* 


GET TORB 


GET CONTROL BYTE VALUE 


PLACE IT IN RUFFER 


GET 2 CHARACS FROM CDRAUF 
STORE IN LPBUF2 

AND 1 TO COUNTER 

72 CHARACTERS? 

IF NOT, GET MORE 

PRINT A LINE 


*COMMUNICATIONS CONSOLE I/0* 


* 

$A3,<LPBUF2 
=fR2 

$R2,36 
$R5,<SPACIT 
$R4,<COMCO 
$R2,<LPBUF 1 
$R2,$B84,71RBAN 
$R4,7 
$RUO,$R4.Z71TRRNG 
S$PRe 
$R3,<QUES2.8R2 
$R3,<LPBUF2.SR2 
$R2,1 

$R2,3 

COMQUE 
$B4,<COMCO 
§RAS,<ZIOREQ 
£R1,COMIN 

TWIGS 

$R3,<TERM 

COMM] 

=SR2 

QUERY 
$B4,<COMCI 
$RS,<ZIORER 
=$Re2 
$R3,<COMBFR,$R2 
$R3,<CDRBUF,§$R2 
SR2,1 
$R2,1 
ENDIT 
$R2,36 
COMM 
$B87,GETIME 
COMIN 

* 


CLEAR BUFFER TO SPACES 
GET IORB 

GET CONTROL BYTE 

AND STORE ADDRESS 


CLEAR COUNTER 


STORE MESSAGE IN OUTPUT BUFFER 
ADD 4 TO COUNTER 

6 CHARACTERS? 

IF NOT, READ SOME MORE 


OTHERWISE, SEND MESSAGE 
IF STATUS OK, GO TO READ INPUT 
ELSE, DEVICE ERROR 


GET TORB 
READ COMM CONSOLE INPUT 


‘CLEAR COUNTER TO ZERO 


GET TWO CHARACTERS 
AND STORE IN CORBUF 
ADD 1 TO COUNTER 


COMPARE TO 1 


GO CHECK IF THEY ARE TC 

72 CHARACTERS? 

YF NOT, GET MORE 

ELSE,GO GET THE TIME 

GQ READ MORE FROM COMM CONSOLE 


PT-O 


67NWV 


COM200 


000352 
000353 
900354 
900355 
000356 
000357 
000358 
000359 
009360 
900361 


090362 


000363 


000364 
000365 


000366 


090367 
000368 
000369 
090370 
000371 
NN0372 
000373 
000374 
090375 
090376 
000377 
090378 
0009 ERR C 


T6022 


O1he 
0146 
OLAT 
01CF 
OLF7 
GFA 
NAIC 
O21n 
O@Le 
OA1F 
0220 
N2e1 
N22e 
0223 
0224 
9225 
02246 
0227 
022A 
0229 
O22Ah 
N2eP 
d2eC 
O2er 
O22E 
0236 
237 
n238 
g239 
023A 
0238 
N25C 
O23n 
O23F 
O23F 
0240 
0244 
Neue 


deus 

N245 

0246 
OUNT 


L6 ASSEMBLER=0200 


ecus 


Sus 


0707 
43uF 
ana 
O14eF 
du20 
4552 
SeuF 
S20} 
414C 
4C29 
4aur 
4E&S 
44aas 
S649 
43as 
ecdgs 
S252 
4FS?2 


uzaF 
apan 
A14F 
QU3A 
4oue 
5055 
Sasa 
43a1 
S2ud 
uO4E 
2020 
eF 20 
3AP0 


OF Ot 
0060 


FEFQ 


COeM TEST PROGRAM 


* 

* 
KSRAUF 
LPRUF I 
LPRUF?2 
CNRBUF 
TERM 
COMBFR 
BELLS 
MSG1 


MSGe 


MSG3 


TIMER 
QUES 


QUES? 


CHe 
CH4 
CH6 
BLANKS 
SLASH 
COLON 
* 

* 

* 
FINTS 


TEXT 


TEXT 


RESV 
TEXT 


TEXT 


TEXT 
TEXT 
TEXT 
nc 

TEXT 
TEXT 


NAP 
HLT 
END 
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*DEFINITIONS ANN EQUATES 


* 

4 

4 At 

an 

40 

‘TC! 

36 

Z'O0707! 

"COMMAND ERROR] 


‘ALL DONE? 


"DEVICE FRROR! 


R 
"COMMANDS! 


"TNPLUTSs * 


‘cat 
tenet 
"tat 
x'poen' 
‘/ ' 

te ' 

* 

* 

* 

CHe 


comeot 


ACTION 
CLM ACTION DURING LOADING, 3-13 
ELACT COMMAND (END LOAD COMMAND), 
A-13 
LACT COMMAND (LOAD ACTION), A-17 


ACTIVATE 
ACTIVATE LEVEL COMMAND (AL), 4-5 


ADDRESS 

ASSEMBLY LANGUAGE START ADDRESS 
DEFINITION, 3-17 

COBOL LANGUAGE START ADDRESS 
DEFINITION, 3-18 

ELOC COMMAND (DEFINE ADDRESS 
SYMBOL), A-14 

FORTRAN LANGUAGE START ADDRESS 
DEFINITION, 3-17 


ADMOD 
ADMOD COMMAND (ADD LOAD MODULE), 
A-4 


AL 
ACTIVATE LEVEL COMMAND (AL), 4-5 


AR 
ALL REGISTERS COMMAND (AR), 4-5 


AREA(S) 
DATA STRUCTURE AREAS, 2-19 
ESTABLISHING OVERLAY AREAS, 2-21 
TSA COMMAND (TRAP SAVE AREA 
DEFINITION), A-23 


ASSEMBLY 
ASSEMBLY LANGUAGE START ADDRESS 
DEFINITION, 3-17 


ASSIGN 
ASSIGN COMMAND (AS), 4-5 


ATFILE 
ATFILE COMMAND (ATTACH FILE), A-4 


ATLRN 
ATLRN COMMAND (ATTACH LRN), A-5 


ATTACH 
ATFILE COMMAND (ATTACH FILE), A-4 
ATLRN COMMAND (ATTACH LRN), A-5 


BES 
BES SOFTWARE FOR APPLICATION 
DEVELOPMENT (TBL), 2-3 
BES SOFTWARE FOR APPLICATION 
EXECUTION (TBL), 2-2 
OVERVIEW OF BES SOFTWARE SERVICES, 
2-1 


BINARY 
BINARY SYNCHRONOUS COMMUNICATIONS 
(BSC 2780), 2-29 


INDEX 


BOOTSTRAP 
BOOTSTRAP RECORD FOR NONSTOP CLM 
LOADING (TBL), 3-8 


BREAKPOINT (S) 
LIST ALL BREAKPOINTS COMMAND (L*), 
4-9 
LIST BREAKPOINT COMMAND (LN), 4-10 
SET BREAKPOINT COMMAND (SN), 4-11 


BSC 
BINARY SYNCHRONOUS COMMUNICATIONS 
(BSC 2780), 2-29 
BSC 2780 COMMAND, A-6 


BUFFER 
FILE MANAGER BUFFER HANDLING, 2-10 
SELECTING FILE AND BUFFER MANAGEMENT 
TECHNIQUES, 2-8 
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